]> git.ipfire.org Git - thirdparty/coreutils.git/commit
doc: improve version-sort doc
authorPaul Eggert <eggert@cs.ucla.edu>
Tue, 8 Feb 2022 18:52:10 +0000 (10:52 -0800)
committerPaul Eggert <eggert@cs.ucla.edu>
Tue, 8 Feb 2022 18:52:43 +0000 (10:52 -0800)
commitcedf627a901e067ad3a63f0fc20f3376ed59786e
treec952312c0225635e8e46d43e0a9ebb2543e56c6f
parentb65ff7e4d06334e5a96ba14c6157b8213373b3b8
doc: improve version-sort doc

* doc/coreutils.texi, doc/sort-version.texi:
Capitalize “Coreutils”.
* doc/sort-version.texi: Don’t emphasize natural sort so much,
since Coreutils has just version sort.
Use the term “lexicographic” instead of “alphabetic” or “standard”.
Suggest combining ‘V’ with ‘b’, and show why ‘b’ is needed.
Use shorter titles for sections, as GNU Emacs displays info poorly
when titles are too long to fit in a line.
Use @samp instead of @code for samples of data.
Do not use @samp{@code{...}}; @samp{...} should suffice and
double-nesting looks bad with Emacs.
Omit blank lines in examples that would not be present
in actual shell sessions.
Quote with `` and '', not with " or with '.
Mention dpkg --compare-versions more prominently.
Don’t rely on "\n" being equivalent to "\\n" in shell args.
Prefer Unicode name for hyphen-minus.
doc/coreutils.texi
doc/sort-version.texi