tests: date: check that options can follow the format string

* tests/date/date.pl (@Tests): Add the test case.

doc: relax github issue/pull-request instructions

Be more accepting of github issues and pull-requests.
Be a bit less verbose in info provided.

tests: sort: ensure --batch-size=(rlimit+1) fails

* tests/sort/sort-merge-fdlimit.sh: Add test case.
https://github.com/coreutils/coreutils/pull/182

tests: coreutils: remove redundant validity check

* tests/misc/coreutils.sh: Remove the check for non-empty coreutils.h,
as the existing `print_ver_ coreutils` is sufficient to determine
support for single binary mode.
https://github.com/coreutils/coreutils/pull/189

tests: cp: ensure --debug output failure is diagnosed

* tests/cp/debug.sh: cp diagnostics are written to stdout,
so ensure output errors are diagnosed.
https://github.com/coreutils/coreutils/pull/192

tests: arch: add option parsing check

* tests/misc/arch.sh: Ensure -- to indicate end of options is accepted.
https://github.com/coreutils/coreutils/pull/191

tests: date: check dotted EU dates in combination

* tests/date/date.pl: Add other date elements
to ensure abbreviated dotted dates are parsed appropriately.
Corresponds to gnulib commit 451042cb76

build: update gnulib to latest

tests: determine errno string more efficiently

* tests/misc/read-errors.sh: Use getlimits_ determined EIO error string,
rather than inferring the string from bash's output.
See https://bugs.gnu.org/80353

tests: getlimits: output error strings

* src/getlimits.c (main): Iterate over defined errnos,
and output shell compatible error strings.
* tests/Coreutils.pm: Adjust so shell quotes are stripped.

maint: pinky: reduce variable scope

* src/pinky.c (create_fullname, idle_string, print_entry)
(print_long_entry, main): Declare variables where they are used instead
of at the start of the function. Initialize variables where they are
declared.

maint: remove extraneous code from test

* tests/misc/usage_vs_refs.sh: Remove copy and paste slop.
* tests/local.mk: Fix indentation.

nl: support multi-byte section delimiters

* NEWS: Mention the improvement.
* src/nl.c: Include mcel.h.
(DEFAULT_SECTION_DELIMITERS): Resize to fit 2 multi-byte characters.
(section_del_len): New variable.
(check_section): Compare against section_del_len instead of 2.
(main): Support multi-byte characters for the -d option.
* tests/nl/multibyte.sh: New file.
* tests/nl/nl.sh: New file, moved from tests/misc/nl.sh.
* tests/local.mk (all_tests): Add the new test. Adjust the existing
tests file name.
* cfg.mk (exclude_file_name_regexp--sc_space_tab): Adjust Adjust the
existing tests file name.

tests: fix false failure with dash or ksh

* tests/misc/read-errors.sh: Avoid dash or ksh as they
do _not_ print an error message upon EIO from read.
Fixes https://bugs.gnu.org/80353

date: add tests and NEWS for dd.mm.yy support

* NEWS: Mention the new feature.
* tests/date/date.pl: Add test cases.

build: update to latest gnulib

* gnulib: Update to pick up support for dd.mm.yy format
in parse-datetime.

build: fix --enable-single-binary=hardlinks with dash

With dash as /bin/sh, you get the error
```
checking for sys/capability.h... yes
./configure: 95775: test: no: unexpected operator
checking for working fork... yes
```

* configure.ac: Use '=' in test for equality, not '==',
for POSIX shell compatibility.
* NEWS: Mention the build fix.

tests: ptx: ensure bad unicode is supported

* tests/ptx/ptx-overrun.sh: Ensure bad_unicode() is processed.

tests: cp: ensure read-only dir perms preserved

* tests/cp/readonly-dir.sh: Add new test.
* tests/local.mk: Reference new test.
Identified here https://github.com/uutils/coreutils/issues/7961

doc: NEWS: mention the recent kill documentation fix

* NEWS: Mention that the kill documentation now has the anchors expected
by 'kill --help'.

tests: fold: check that all files are processed

* tests/fold/multiple-files.sh: New file.
* tests/local.mk (all_tests): Add the test.

tests: nl: check that all files are processed

* tests/misc/nl.sh: Add a test case.

maint: unexpand: remove dead store

The assign to next_tab_column in the backspace branch is never
read; in fact it's always written and then read solely inside the
blank branch.

Move the declaration of 'next_tab_column' down into the blank
branch, and remove its assignment in the backspace branch.

Spotted by the 'infer' static checker.

* src/unexpand.c (unexpand): Remove dead store of next_tab_column.

tests: ptx: add a robustness test case

* tests/ptx/ptx-overrun.sh: Ensure input is processed without issue.
https://github.com/coreutils/coreutils/pull/184

doc: pr: use -COLS consistently

Help this back from release as would break a couple of translations.

* src/pr.c: Use COLS rather than COLUMN consistently
in comments and usage().

doc: kill: adjust documentation to produce html anchors for --help

* doc/coreutils.texi (kill invocation): Adjust documentation to use the
@optItem macros.
Fixes https://bugs.gnu.org/80339
Fixes https://github.com/coreutils/coreutils/issues/185

maint: remove local maintainer-makefile adjustment

* gl/top/maint.mk.diff: Remove as the fix is now in gnulib.
* gl/local.mk: Remove the diff reference.

maint: update gnulib to latest

build: propagate $SHELL to makeinfo-wrapper.sh

A user that had an environment with SHELL=/usr/bin/fish
reported the following when trying to build info docs:

  build-aux/missing (line 4): Unsupported use of '='. In fish

* doc/local.mk: Propagate make's SHELL to our
makeinfo wrapper, so that the substituted ${SHELL}
uses a compatible shell from the Makefile.

tests: df: check that --sync always calls sync before statfs

* tests/df/sync.sh: New file.
* tests/local.mk (all_tests): Add the test.

stat,df: remove an unnecessary alloca

* src/find-mount-point.c (find_mount_point): Don't call ASSIGN_STRDUPA
on the result of dir_name.

maint: post-release administrivia

* NEWS: Add header line for next release.
* .prev-version: Record previous version.
* cfg.mk (old_NEWS_hash): Auto-update.

version 9.10

* NEWS: Record release date.

maintainer-makefile: propagate MAKEINFO to gendocs

Make this change temporarily in coreutils.
Move to gnulib after v9.10 is released.

* top/maint.mk (web-manual): Propagate MAKEINFO explicitly,
rather than requiring it exported in the environment,
which can be awkward on Solaris make for example.

tests: avoid false failure sync'ing busy systems

* tests/misc/sync.sh: Increase the timeout to 60s,
and restrict the case to when RUN_VERY_EXPENSIVE_TESTS=yes.

doc: improve highlighting of dd --help translations

* src/system.h (oputs_): Ensure we're not matching '-' in
translated descriptions.  Also support highlighting only
dd "foo=bar" when the description is separated with a single space.

maint: avoid prohibit-const-char syntax check failure

* src/copy.c: Avoid prohibit-const-char failure,
newly triggered by the (correct) recent adjustment.

doc: move xgettext: hint to the correct translated string

* src/fmt.c (usage): Move comment down to the newly separated string.
Discussed in https://github.com/coreutils/coreutils/issues/178

maint: space between ‘char’ and ‘*’

tests: date: test that %% in the string is not replaced

* tests/date/percent-percent.sh: New file.
* tests/local.mk (all_tests): Add it.

doc: improve highlighting of single spaced translations

* src/system.h (oputs_): Translations sometimes use a single space
between an option and its description.  They only do this though
for long options since they result in less available screen space.
Therefore be more strict with option matching once we've encountered
a long option, which supports the more varied formats often
associated with short options.

maint: avoid syntax-check failure

* man/date.x: Add a copyright header to fix sc_copyright_check.
Reported by Bruno Haible.

tests: tac: test --regex with anchors in the separator

* tests/tac/tac.pl (@Tests): Add a few test cases.

doc: fit in 80 columns

doc: fix date(1) synopses etc

Font problem reported by Michael Aramini via Alejandro Colomar
<https://bugs.gnu.org/80258>.  This patch also fixes some
longstanding confusion with date synopses.
* src/date.c (usage): Do not imply that only -u can be used with
MMDDhhmm..., and do not put misleading brackets around the latter.

tests: mktemp: export LC_ALL

* tests/mktemp/bad-unicode.sh: Run this test case using multiple
locales.

doc: support TAB as a delimiter between --option and description

* src/system.h (oputs_): Treat a single TAB as an option delimiter.
Some zh translations use this delimiter format.

tests: chgrp: allow a numeric user id to be printed

* tests/chgrp/from.sh: If 'id' cannot find a user name for user id 1,
expect the user id to be printed in the message of 'chgrp'.
Reported by Bruno Haible.

tail: fix EINTR handling on older systems

tail(1) could fail with an "Interrupted system call"
diagnostic, on some systems like Centos 5 (Linux 2.6.18).
This was seen with tests/tail/overlay-headers.sh
which sends SIGCONT, which should not induce a failure.

* src/tail.c (tail_forever_inotify): Retry the poll()
upon receiving a non terminating signal, and the syscall
is not automatically restarted by the system.
* NEWS: Mention the bug fix.
Reported by Bruno Haible.

tests: avoid failures if 'ulimit -n' cannot set file descriptor limits

This fixes test failures seen on Haiku.

* tests/ls/recursive.sh: Run 'ls' even if ulimit fails.
* tests/split/r-chunk.sh: Run 'split' even if ulimit fails.
* tests/sort/sort-merge-fdlimit.sh: Skip test if 'ulimit -n' cannot set
file descriptor limits.
Reported by Bruno Haible.

tests: dd: avoid EPERM false failure on Solaris

* tests/dd/fail-ftruncate-fstat.sh: Also map the "Not owner"
error for EPERM seen on earlier Solaris 11 releases.
Reported by Bruno Haible.

doc: nproc: mention OpenMP env vars in --help

* src/nproc.c (usage): Clarify the impact of 'OMP_NUM_THREADS'
and 'OMP_THREAD_LIMIT' in --help and the man page.
Also mention that nproc(1) will always return > 0.
Fixes https://bugs.gnu.org/80243

build: update to latest gnulib

* gnulib:
  - getdelim, getline: Don't replace these functions on glibc
  - selinux: fix link errors with termux

tests: recognize SELinux support on Android

* init.cfg (require_selinux_): Also try to see if 'mount' lists the
selinuxfs.

tests: stty: avoid false failure if resizing terminal

* tests/stty/stty-row-col.sh: Skip the test if we detect terminal
resizing.  Also more robustly restore the original size.

tests: readlink: avoid a false failure on Haiku

* tests/readlink/readlink-posix.sh: Allow the "A" in "Argument" to be
capitalized in return value of strerror (EINVAL).

doc: NEWS: add a missing quotation mark

* NEWS: Add a closing quotation mark.

tests: usage_vs_refs.sh: fix false failure with Alpine

* tests/misc/usage_vs_refs.sh: Fix missing escape on literal {,
required by busybox grep.
Reported by Bruno Haible.

doc: dir,vdir: add dircolors(1) reference to man pages

* man/dir.x: Add dircolors(1) to "SEE ALSO" section.
* man/vdir.x: Likewise.

doc: dir,vdir: fix anchor refs from --help

* src/system.h (oputs_): Map from dir,vdir to ls.

doc: stat: fix highlighting of --format

* src/stat.c (usage): Add missing comma after -c.

doc: NEWS: minor adjustments

* NEWS: Fix typos, and move item to more appropriate section.

doc: pr: fix --help output output

* src/pr.c (usage): Use consistent alignment with -J,
and highlight --pages using oputs().

doc: help2man: handle leading '+' in options

* man/help2man: Fix indentation of options with leading '+'.

tests: fix false failure with pr -COLS

* tests/misc/usage_vs_getopt.sh: Fix false failure induced
by commit v9.9-239-ga06f0cf67

doc: use TERM=dumb rather than HELP_NO_MARKUP to disable markup

This is a more standard mechanism to disable markup.

* src/system.h (oputs_): Logic change to honor TERM=dumb,
rather than HELP_NO_MARKUP=something.
* doc/coreutils.texi: Adjust the description for --help.
* man/local.mk: Ensure TERM is set to something,
so that man pages have links included.
* man/viewman: Just honor users $TERM.
* tests/misc/getopt_vs_usage.sh: Remove env var complication,
as TERM is unset automatically.
* tests/misc/usage_vs_refs.sh: Likewise.
* NEWS: Adjust the change in behavior note.

tests: avoid false failure with non standard path

* tests/misc/usage_vs_refs.sh: Properly quote arguments
to avoid false failure with paths containing spaces etc.

tests: avoid infinite loop in dd failure edge case

* tests/tee/tee.sh: If dd failed, then tee would spin
writing to the fifo forever, so add a timeout protection.
This was noticed with `export LD_PRELOAD=libasan.so.8`
with a non ASAN build, which induced a failure in dd invocations.

tests: avoid false failure with sanitizer builds

* init.cfg (sanitizer_build_): Add a helper to detect if a program
is built against a sanitizer.
* tests/df/no-mtab-status-masked-proc.sh: Skip if a sanitizer build.

stat,tail: sync with latest Linux file systems

* src/stat.c (human_fstype): Add "guest-memfd".
* NEWS: Mention the improvement.

tests: avoid false failure on setgid dir

* tests/misc/mknod.sh: Skip a portion of the test
in the edge case of setgid directories.

ls: --hyperlink: switch to more standard delimiters

* src/ls.c (quote_name): Use ST (ESC \) rather than BEL,
as that's the only terminator mentioned in at least
ECMA-48, DEC STD 070, and EK-VT520-RM.
* NEWS: Mention the change in behavior.
* tests/ls/hyperlink.sh: Adjust accordingly.

Suggested by Egmont Koblinger.

tests: ensure there is an anchor for each --help option

* tests/misc/usage_vs_refs.sh: A new test to correlation options
listed in --help, and anchors referenced in the texinfo (html) manual.
* tests/local.mk: Add the new test.

doc: NEWS: describe the --help markup configuration options

* NEWS: Mention build and runtime config options.

doc: adjust --help hyperlinks to more standard format

* src/system.h (oputs_): Use ST rather than BEL.

doc: add commentary on details of --help references

* src/system.h: Mention why we don't bother with (the overhead of)
hostnames in these URLs, and why --help,--version link are special.

doc: cp: group related -HLP descriptions

* src/cp (usage): The -HLP options are close
in functionality and close alphabetically, so describe together.
* doc/coreutils.texi (cp invocation): Likewise.

doc: cp: document --keep-directory-symlink in correct location

* src/cp.c (usage): Move to alphabetically in list.
* doc/coreutils.texi (mv invocation): Move description from here ...
(cp invocation): ... to here.

doc: ls: document --block-size in the manual

* doc/coreutils.texi (ls invocation): Document --block-size

doc: who: document --users in manual

* doc/coreutils.texi (who invocation): Mention that --users
is equivalent to -u.
* src/who.c (usage): Mention -u shows idle time.

doc: id: document -a in manual

* doc/coreutils.texi (id invocation): Mention this option is ignored.

doc: more indexing fixes in manual

* doc/coreutils.texi: Add missing anchors.
* src/pr.c (Usage): Adjust to use -COLS, to avoid a clash
with the additional anchor added to the manual.
Also markup the --columns option as done for other options.
* tests/split/line-bytes.sh: Also fix --lines-bytes typo here.

doc: tty: fix indexing in texinfo

* doc/coreutils.texi: Fix recently introduced typo.
* THANKS.in: Remove as now committed to the repo.

doc: make legacy digest utility --help reference cksum nodes

* src/system.h (oputs_): Map md5sum etc. to cksum urls,
as we only have cksum anchors in the manual to avoid
creating anchors for all of the legacy digest utilities.

doc: tweak tests to avoid false failure with --help

* tests/df/df-output.sh: Use a more relaxed match.
* tests/du/inodes.sh: Likewise.

doc: all: use option highlighting and more standard alignment

Adjust all utils to:
  - Have a separate translation per option
  - Use either oputs() or oprintf(), instead of fputs() or printf().
  - Use more standard alignment as discussed in previous commits.
  - Various tweaks to descriptions.

doc: readlink: improve option ordering in texinfo

* doc/coreutils.texi (readlink invocation): Order -q,-s alphabetically.

doc: chcon: use more standard -HLP desciptions

* src/chcon.c (usage): Use emit_symlink_recurse_options ("-P").

doc: highlight -HLP options

* src/system.h (emit_symlink_recurse_options): Highlight -HLP,
for chmod, chcon etc.

doc: put --help and --version descriptions on separate line

* src/system.h: This aligns the output with the option
description format used in most commands

doc: ls: put option description on separate line to option

* src/ls.c (usage): This is less constrained when writing comments,
and more consistent in output alignment.  There is less delineation
between options and descripts, but given options are highlighted
by default now, this is a more appropriate format to use.
Note consistently showing description on the line following the option,
avoids any issue with the user needing to visually line up
the option with a description far to the right.
Note this format more closely aligns with that used in man pages.

doc: viewman: a new helper to quickly view formatted man pages

Use like: man/viewman ls

* man/viewman: Generate man page on the fly, and view.

doc: help2man: account for undisplayed markup in indenting calculations

* man/help2man: This is significant with the indented line
following the dd bs=BYTES "option" at least.

doc: help2man: convert all hyperlinks, not just ones in --options

* man/help2man: Make the (--?) part of the match optional.
Note we still extract the dashes, to support the existing
option matching logic in help2man.

doc: help2man: support alternate format OSC hyperlinks

* man/help2man: The BEL terminator format was already supported.
Add support for ESC + backslash terminator.  Also split out
and document the regular expression.

doc: help2man: convert OSC hyperlinks

* man/help2man: Convert OSC hyperlinks to roff \X escapes,
which will be converted back to OSC hyperlinks when
the man page is displayed on the terminal.
Note formatting is removed from hyperlinked text by default,
thus relying on how the terminal highlights hyperlinks,
but --bold-refs is honored in this case, in which hyperlinked
text will be marked up as bold, which matches the default
markup used for non hyperlinked options.

doc: help2man: recognise option description with smaller indent

* man/help2man: Allow for a smaller indented option description.
This smaller indentation is present in timeout --help output,
so now the line spacing in timeout.1 is more consistent.
Also having the description on a separate line with
a smaller indentation, is a more general way to present
option descriptions (and what the man page formatting uses already).
We'll be changing many utilities, especially with longer multi-line
descriptions to this new format.

doc: help2man: strip ANSI codes

* man/help2man: With these ANSI codes, output is corrupted,
so it's best to strip these, which allows --help to
outputting formatting and hyperlinks by default.

doc: support highlighting printf formatted options

* src/system.h (oprintf): Add a printf wrapper that
calls oputs_() to markup the formatted text.

doc: support more general option matching

* src/system.h: Support "-p DIR, --tmpdir[=DIR]" option.
Previously only the "-p" was highlighted.
Support highlighting dd option syntax (no '-').
Support test(1) "FILE1 -nt FILE2" syntax.