Re: [Patch] Adding examples to the man pages

[Paul Eggert]

Jim Meyering <address@hidden> writes:

> I could go either way when the single sentence of exit-status
> documentation is all that follows the option descriptions.
> But when there's more than that one sentence, I have a slight
> preference for putting the examples at the end.

Then let's do the latter, as it's simpler to use the same rule everywhere.
I changed the patch to do that, and installed it.
Here's the new output of cat --help:

cat --help
Usage: cat [OPTION] [FILE]...
Concatenate FILE(s), or standard input, to standard output.

  -A, --show-all           equivalent to -vET
  -b, --number-nonblank    number nonblank output lines
  -e                       equivalent to -vE
  -E, --show-ends          display $ at end of each line
  -n, --number             number all output lines
  -s, --squeeze-blank      never more than one single blank line
  -t                       equivalent to -vT
  -T, --show-tabs          display TAB characters as ^I
  -u                       (ignored)
  -v, --show-nonprinting   use ^ and M- notation, except for LFD and TAB
      --help     display this help and exit
      --version  output version information and exit

With no FILE, or when FILE is -, read standard input.

Examples:
  cat f - g  Output f's contents, then standard input, then g's contents.
  cat        Copy standard input to standard output.

Report bugs to <address@hidden>.