[PATCH 6/6] user: Remove nit-picky warnings.

Chris Johns chrisj at rtems.org
Wed Feb 27 06:30:20 UTC 2019

On 26/2/19 5:42 pm, Sebastian Huber wrote:
> I think both presentations make sense. With the $ indication you can place
> multiple commands together with the command output in one block. Using separate
> blocks for commands and output allows you to simply copy and based multiple
> commands to a terminal.

What about the attached patch to the README.txt?

I can add it to the v2 of this patch set.

-------------- next part --------------
From fddc87c8ea588422317cdef112dffae48027ab86 Mon Sep 17 00:00:00 2001
From: Chris Johns <chrisj at rtems.org>
Date: Wed, 27 Feb 2019 17:28:00 +1100
Subject: [PATCH] Add commands and output to the README.

 README.txt | 28 ++++++++++++++++++++++++----
 1 file changed, 24 insertions(+), 4 deletions(-)

diff --git a/README.txt b/README.txt
index e002f60..115d08d 100644
--- a/README.txt
+++ b/README.txt
@@ -415,14 +415,34 @@ existing documentation for an example and if unsure ask.
       5  ^^^^^^ Sub-sub-sub-section
       6  ~~~~~~ Sub-sub-sub-sub-section
-5. For literal output, such as shell commands and code use '::' at the trailing
-   edge of the previous paragraph. Use the '.. code-block::' with
-   'c' for C code and 'shell' for shell code and terminal output. If you need
-   line number use:
+5. For literal output, such as shell commands and code do not use '::'
+   at the trailing edge of the previous paragraph as it generates
+   warnings as the autodetect fails to find a suitable format. Use the
+   '.. code-block::' with a suitable lexical label. The lexers are:
+     http://pygments.org/docs/lexers/
+   Use the short names. For C code use 'c' code and 'shell' for shell
+   scripts and for terminal output use 'none'. If you need line number
+   use:
     .. code-block:: shell
+   We support two forms of commands and outputs.
+   The first is to have a shell command block with just the commands
+   and if required an output block with the output or some of the
+   output. Use 'none' for the output block. Make sure the text clearly
+   states the block is the output, if there it has been edited to make
+   it short and if there are any special operating modes, for example
+   needing to be 'root'.
+   The second is to use a single block of type 'none' with the command
+   and output together as seen in a terminal session. The commands are
+   identifed by the standard shell prompt characters where '$' is a
+   user prompt and '#' is a 'root' prompt.
 6. Use the directives for 'note', 'warning', and 'topic'. Do not add 'TIP',
    'Important' or 'Warning' to the text. Let the mark-up language handle
    this. The supported directives are:

More information about the devel mailing list