Feedback on the GNU Coding Standards for command-line interfaces

[David Apps]

Thank you for your message.

I made the changes and used
diff -c original_file edited_file
to give the context diff at the end of this message.
If you want me to do something different, please tell me.

I could not check that the changes between @menu and @end menu work.
the output that I get with
texi2any --html -no-split standards.texi
is different to that on the website.
The makefiles mention gendocs.sh, but I could not find this.
Hence my attempt to avoid the conversion of
--version and --help
to
–version and –help
might not work.
Sorry.

I hope that this is better than nothing.

Thank you.

David

*** standards.texi      2024-05-26 16:31:50.075317224 +0100
--- standards_edited.texi       2024-05-26 16:32:16.133157306 +0100
***************
*** 1007,1014 ****
  command line.
  
  @menu
! * --version::       The standard output for --version.
! * --help::          The standard output for --help.
  @end menu
  
  @node --version
--- 1007,1014 ----
  command line.
  
  @menu
! * --version::       The standard output for @option{--version}.
! * --help::          The standard output for @option{--help}.
  @end menu
  
  @node --version
***************
*** 1066,1072 ****
  each on a separate line.
  
  Next should follow a line stating the license, preferably using one of
! abbreviations below, and a brief statement that the program is free
  software, and that users are free to copy and change it.  Also mention
  that there is no warranty, to the extent permitted by law.  See
  recommended wording below.
--- 1066,1072 ----
  each on a separate line.
  
  Next should follow a line stating the license, preferably using one of
! the abbreviations below, and a brief statement that the program is free
  software, and that users are free to copy and change it.  Also mention
  that there is no warranty, to the extent permitted by law.  See
  recommended wording below.
***************
*** 2137,2143 ****
  @samp{-s} in @code{tac}.
  
  @item sequence
! Used by @code{recode} to chose files or pipes for sequencing passes.
  
  @item shell
  @samp{-s} in @code{su}.
--- 2137,2143 ----
  @samp{-s} in @code{tac}.
  
  @item sequence
! Used by @code{recode} to choose files or pipes for sequencing passes.
  
  @item shell
  @samp{-s} in @code{su}.