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

Gedare Bloom gedare at rtems.org
Tue Dec 19 20:49:18 UTC 2023 

lgtm, thanks

On Mon, Dec 18, 2023 at 7:59 PM <chrisj at rtems.org> wrote:
>
> 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
>
> _______________________________________________
> devel mailing list
> devel at rtems.org
> http://lists.rtems.org/mailman/listinfo/devel

More information about the devel mailing list