[rtems-docs PATCH] user: Automatic version number fixes

chrisj at rtems.org chrisj at rtems.org
Tue Dec 19 02:59:25 UTC 2023 

From: Chris Johns <chrisj at rtems.org>

Updates #4695
---
 user/exe/initialization.rst    |  3 +--
 user/tracing/captureengine.rst | 20 ++++++++++----------
 user/tracing/examples.rst      | 12 ++++++------
 3 files changed, 17 insertions(+), 18 deletions(-)

diff --git a/user/exe/initialization.rst b/user/exe/initialization.rst
index f4b5d7e..1100006 100644
--- a/user/exe/initialization.rst
+++ b/user/exe/initialization.rst
@@ -83,13 +83,12 @@ initialization is performed before multitasking is started.
 
 The RTEMS Tool ``rtems-exeinfo`` can provide some detail about the registered
 handlers. The following shows the initialization handlers for the Hello World
-sample application in the RTEMS kernel's testsuite::
+sample application in the RTEMS kernel's testsuite:
 
 .. code-block:: none
 
  $ rtems-exeinfo --init arm-rtems at rtems-ver-major@/c/xilinx_zynq_zedboard/testsuites/samples/hello.exe
  RTEMS Executable Info @rtems-ver-major at .5416cfa39dd6
- $ rtems-exeinfo --init arm-rtems at rtems-ver-major@/c/xilinx_zynq_zedboard/testsuites/samples/hello.exe
  exe: arm-rtems at rtems-ver-major@/c/xilinx_zynq_zedboard/testsuites/samples/hello.exe
 
  Compilation:
diff --git a/user/tracing/captureengine.rst b/user/tracing/captureengine.rst
index a8bca53..137c555 100644
--- a/user/tracing/captureengine.rst
+++ b/user/tracing/captureengine.rst
@@ -14,22 +14,22 @@ runtime and does not require RTEMS or your application to be rebuilt in order
 to use it.
 
 The Capture Engine's sample testcase for the `sparc/erc32` is available in
-build directory created when building RTEMS in the path
-file: `sparc-rtems5/c/erc32/testsuites/samples`. In order to access the capture
-testcase perform the following set of operations inside the RTEMS build
-directory.
+build directory created when building RTEMS in the path file:
+`sparc-rtems at rtems-ver-major@/c/erc32/testsuites/samples`. In order to access
+the capture testcase perform the following set of operations inside the RTEMS
+build directory.
 
 .. code-block:: none
 
-  $ cd /sparc-rtems5/c/erc32/testsuites/samples
-  $ sparc-rtems5-run ./capture.exe
+  $ cd /sparc-rtems at rtems-ver-major@/c/erc32/testsuites/samples
+  $ sparc-rtems at rtems-ver-major@-run ./capture.exe
 
 
   *** BEGIN OF TEST CAPTURE ENGINE ***
-  *** TEST VERSION: 5.0.0.de9b7d712bf5da6593386fd4fbca0d5f8b8431d8
+  *** TEST VERSION: @rtems-ver-major at .@rtems-ver-minor at .0.de9b7d712bf5da6593386fd4fbca0d5f8b8431d8
   *** TEST STATE: USER_INPUT
   *** TEST BUILD: RTEMS_NETWORKING RTEMS_POSIX_API
-  *** TEST TOOLS: 7.3.0 20180125 (RTEMS 5, RSB a3a6c34c150a357e57769a26a460c475e188438f, Newlib 3.0.0)
+  *** TEST TOOLS: 7.3.0 20180125 (RTEMS @rtems-ver-major@, RSB a3a6c34c150a357e57769a26a460c475e188438f, Newlib 3.0.0)
   Press any key to start capture engine (20s remaining)
   Press any key to start capture engine (19s remaining)
   Press any key to start capture engine (18s remaining)
@@ -101,10 +101,10 @@ number of context switches between tasks we are not interested in.
 .. code-block:: none
 
   *** BEGIN OF TEST CAPTURE ENGINE ***
-  *** TEST VERSION: 5.0.0.de9b7d712bf5da6593386fd4fbca0d5f8b8431d8
+  *** TEST VERSION: @rtems-ver-major at .@rtems-ver-minor at .0.de9b7d712bf5da6593386fd4fbca0d5f8b8431d8
   *** TEST STATE: USER_INPUT
   *** TEST BUILD: RTEMS_NETWORKING RTEMS_POSIX_API
-  *** TEST TOOLS: 7.3.0 20180125 (RTEMS 5, RSB a3a6c34c150a357e57769a26a460c475e188438f, Newlib 3.0.0)
+  *** TEST TOOLS: 7.3.0 20180125 (RTEMS @rtems-ver-major@, RSB a3a6c34c150a357e57769a26a460c475e188438f, Newlib 3.0.0)
   Press any key to start capture engine (20s remaining)
   Press any key to start capture engine (19s remaining)
   Press any key to start capture engine (18s remaining)
diff --git a/user/tracing/examples.rst b/user/tracing/examples.rst
index 2b673d4..ed0c722 100644
--- a/user/tracing/examples.rst
+++ b/user/tracing/examples.rst
@@ -48,19 +48,19 @@ BSP is configured with the following command -
 
 .. code-block:: none
 
-  ../rtems/configure --target=sparc-rtems5 --prefix=/development/rtems/5 \
+  ../rtems/configure --target=sparc-rtems at rtems-ver-major@ --prefix=/development/rtems/5 \
   --enable-networking --enable-tests --enable-rtemsbsp=erc32 --enable-cxx
 
 The next two commands are used to link the fileio executable.The `-B` option
 signifies the use of the complete path to the required directory or file. Write
-the full path instead of the path file: `sparc-rtems5/erc32/lib/` in the
+the full path instead of the path file: `sparc-rtems at rtems-ver-major@/erc32/lib/` in the
 following commands according to your installation. Also confirm the path of the
 fileio's executable and object files in the last line of the command according
 to your installation.
 
 .. code-block:: none
 
-  sparc-rtems5-gcc -Bsparc-rtems5/erc32/lib/ \
+  sparc-rtems at rtems-ver-major@-gcc -Bsparc-rtems at rtems-ver-major@/erc32/lib/ \
   -qrtems -mcpu=cypress -O2 -g -ffunction-sections \
   -fdata-sections -Wall -Wmissing-prototypes -Wimplicit-function-declaration \
   -Wstrict-prototypes -Wnested-externs -Wl,--gc-sections -mcpu=cypress \
@@ -97,10 +97,10 @@ The output from the above commands will be as follows:
 .. code-block:: none
 
   *** BEGIN OF TEST FILE I/O ***
-  *** TEST VERSION: 5.0.0.de9b7d712bf5da6593386fd4fbca0d5f8b8431d8
+  *** TEST VERSION: @rtems-ver-major at .@rtems-ver-minor at .0.de9b7d712bf5da6593386fd4fbca0d5f8b8431d8
   *** TEST STATE: USER_INPUT
   *** TEST BUILD: RTEMS_NETWORKING RTEMS_POSIX_API
-  *** TEST TOOLS: 7.3.0 20180125 (RTEMS 5, RSB a3a6c34c150a357e57769a26a460c475e188438f, Newlib 3.0.0)
+  *** TEST TOOLS: 7.3.0 20180125 (RTEMS @rtems-ver-major@, RSB a3a6c34c150a357e57769a26a460c475e188438f, Newlib 3.0.0)
   Press any key to start file I/O sample (20s remaining)
   Press any key to start file I/O sample (19s remaining)
   Press any key to start file I/O sample (18s remaining)
@@ -128,7 +128,7 @@ The output from the above commands will be as follows:
      starting shell
    =========================
 
-  Welcome to rtems-5.0.0 (SPARC/w/FPU/erc32)
+  Welcome to rtems- at rtems-ver-major@. at rtems-ver-minor@.0 (SPARC/w/FPU/erc32)
   COPYRIGHT (c) 1989-2008.
   On-Line Applications Research Corporation (OAR).
 
-- 
2.42.0

More information about the devel mailing list