coreutils/doc, branch v9.4

maint: spelling fixes, including author names

2023-08-28T21:06:43Z

Most of this just affects commentary and documentations. The only significant behavior change is translating author names via proper_name_lite rather than proper_name_utf8, or not translating them at all. proper_name_lite is good enough for coreutils and avoids the bloat that had coreutils not using Gnulib proper_name. * bootstrap.conf (gnulib_modules): Use propername-lite instead of propername. (XGETTEXT_OPTIONS): Look for proper_name_lite instead of for proper_name_utf8. * cfg.mk (local-checks-to-skip): Remove sc_proper_name_utf8_requires_ICONV, since we no longer use proper_name_utf8. (old_NEWS_hash): Update. (sc_check-I18N-AUTHORS): Remove; no longer needed.

cksum: adjust tests and docs to binary mode handling

2023-08-27T18:53:52Z

Following commit v9.3-80-g5e1e0993b which makes cksum match the output of the standalone utilities... * doc/coreutils.texi (cksum output modes): Remove the mention that cksum never outputs a binary indicator, as that's no longer the case. * tests/cksum/b2sum.sh: Avoid outputting a binary indicator. * tests/cksum/sm3sum.pl: Likewise.

doc: reorg texinfo for the checksumming utilities

2023-08-22T11:09:57Z

* doc/coreutils.texi: Reorg so that 'cksum invocation' is the main node listing all options and output formats, which is then referenced by the descriptions of the standalone utilities. Use macros in the description of the standalone utilities rather than referencing 'md5sum invocation' to be more direct.

doc: cksum: remove -b description from texinfo

2023-08-21T21:20:39Z

* doc/coreutils.texi (cksum invocation): Following commit 5e1e0993 also remove the desciption of the -b option for the cksum command.

doc: clarify tail -n/-c +NUM operation

2023-07-20T14:13:01Z

tail -n/-c +NUM, is different from tail -n/-c NUM, and head -n/-c NUM, and head -n/c -NUM, in that it specifies a 1 based index rather than a count to skip/include. So clarify this in tail --help and tail info manual. Note we also mention this gotcha at: https://www.pixelbeat.org/docs/coreutils-gotchas.html#tail * doc/coreutils.texi (tail invocation): Give examples for -c/-n +NUM, to make it clear one has to specify a number 1 larger than might be expected. * src/tail.c (usage): State the skip at start edge case more clearly in the -n description. -c is not often used with tail so we leave full explanation of that to the info manual. Also split the string to simplify translation.

cksum: escape filenames with a leading '\' in --check status

2023-07-11T11:16:41Z

* src/digest.c (digest_check): Also escape in the case that the file name contains '\'. * tests/cksum/md5sum-bsd.sh: Add a test case. * doc/coreutils.texi (md5um invocation): Clarify escaping operation. * NEWS: Mention the bug fix. Fixes https://bugs.gnu.org/64392

build: ensure that makeinfo ≥ 6.8 checks the @menu structure

2023-06-22T22:22:07Z

See . * doc/local.mk (MAKEINFO): New variable. * cfg.mk (_makefile_at_at_check_exceptions): Update.

dd: fix parsing of numbers with more than two multipliers

2023-06-11T22:10:34Z

* src/dd.c (parse_integer): Use recursion to support more than two multipliers. Also protect suffix[-1] access to ensure we don't inspect before the passed string. * tests/dd/bytes.sh: Add test cases. * doc/coreutils.texi (dd invocation): Note the support for specifying many multipliers in a number. * NEWS: Mention the bug fix. Fixes https://bugs.debian.org/1037275

doc: od --strings: clarify operation

2023-06-08T10:06:20Z

* doc/coreutils.texi (od invocation): Remove mention of ASCII, as all printable characters in unibyte locales are output. * src/od.c (usage): Clarify that only NUL terminated strings are displayed, and that it's printable chars, not only graphic chars that are output. I.e., spaces are output also if part of the string. Reported at https://bugs.ddebian.org/1037217

doc: time zone conversion example

2023-05-07T16:17:27Z

* doc/coreutils.texi (Examples of date): Give time zone conversion example.