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.

doc: parse any whitespace as an option/description delimiter

* src/system.c (oputs_): Use isspace() rather than hardcoding.
Note we don't use c_isspace() as we need to support anything
coming from translations.

doc: optimize logic to disable SGR output in --help

* src/system.h (oputs_): Simplify processing if neither
MANUAL_URL or BOLD_MAN_REFS is defined.  Also ensure
we only lookup the HELP_NO_MARKUP env var once per process.

doc: move oputs() to system.h to support all commands

* src/ls.c: Move non ls specific helper to ...
* src/system.h: ... here.

doc: support a configurable manual url

* configure.ac: Support ./configure --enable-manual-url=...
* src/ls.c (oputs): Adjust accordingly.

doc: --help: --disable-bold-man-page-references configures bold refs

* configure.ac: Adjust help text for --disable-bold-man-page-references,
and also define BOLD_MAN_REFS.
* src/ls.c (oputs): Output bold iff BOLD_MAN_REFS is defined.

doc: ls: support styling and links in --help output

* src/ls.c (oputs): A new function that wraps puts(),
but also highlights the --option-text portion, and
adds links to the appropriate part of the online manual.
(usage): Call oputs() rather than puts().
* doc/coreutils.texi (--help): Document new HELP_NO_MARKUP env var,
which can be used in the edge case one wants to suppress ansi escapes.
* tests/misc/getopt_vs_usage.sh: Use HELP_NO_MARKUP to ensure the
test continues to pass.

tests: test: ensure whitespace ignored when parsing numbers

* tests/test/test.pl: Add a test case.

cksum: use more accurate program name in single binary mode

Following commit v9.9-109-gcd5229222

* src/cksum.c (PROGRAM_NAME): In legacy mode, i.e., when built
as a single binary, set the PROGRAM_NAME dynamically based on
the selected digest type.  This is significant in --help
to ensure the correct texinfo node is referenced, and in
--version to ensure the correct utility name is output.

tests: dd: avoid a false test failure on Solaris 11.4

* tests/dd/fail-ftruncate-fstat.sh: Replace the message used by Solaris
11.4 for strerror (EPERM) with the one we expect.

tests: sync: check that all files are processed even when errors occur

* tests/misc/sync.sh: Add the test case.

tests: sync: also test that -d and -f don't block on a FIFO

* tests/misc/sync.sh: Check 'sync fifo' with no arguments, -d, and -f
separately. Only perform the check for -f if RUN_EXPENSIVE_TESTS=yes
since it may be expensive.

build: update to latest gnulib

* gnulib: Update to latest.
* NEWS: Mention the bug fix.
https://github.com/coreutils/coreutils/issues/176

tests: env.sh: avoid multi-call binary considerations

A simpler fix than commit v9.9-4-g3b6efd555
which is less dependent on the exact behavior
of a multi-call binary.

* tests/env/env.sh: Use a local script rather than 'true'.
which may be a symlinked multi-call binary.
https://github.com/coreutils/coreutils/pull/174

doc: post process html with non-GNU make programs

* .gitignore (/build-aux/makeinfo-wrapper.sh):
* Makefile.am (EXTRA_DIST): Remove build-aux/makeinfo-wrapper.sh.
* build-aux/makeinfo-wrapper.sh.in: New file, renamed from
build-aux/makeinfo-wrapper.sh and modified to use @MAKEINFO@ instead of
makeinfo.
* cfg.mk (MAKEINFO): Remove variable.
* configure.ac: Add build-aux/makeinfo-wrapper.sh as a configure file.
* doc/local.mk (MAKEINFO): Define to
$(abs_top_builddir)/build-aux/makeinfo-wrapper.sh.
(AM_MAKEINFOFLAGS): Move over some values from the previous MAKEINFO
definition.

tests: strace: consider splice a "read" syscall

* tests/cksum/cksum-c.sh: Add 'splice' to the injection set.
* tests/misc/read-errors.sh: Likewise.
From https://github.com/coreutils/coreutils/pull/167

maint: prefer NULL to nullptr

NULL is best for C as discussed at:
https://bugs.gnu.org/66221#53

* bootstrap.conf: Remove dependency on nullptr.
* s/nullptr/NULL/.

doc: add more redirections from legacy *sum to cksum

*  doc/coreutils.texi (md5sum invocation, sha1sum invocation,
b2sum invocation, sha2 utilities): Mention these are legacy interfaces,
and reference 'cksum invocation'.
*  src/cksum.c (usage): Likewise.
*  man/md5sum.x: Redirect to cksum, rather than individual utils.
*  man/sha1sum.x: Likewise.

tests: use `command -v` to identify binary

* tests/misc/coreutils.sh: Be more flexibile by using `command -v`
to identify the binary to be executed, rather than linking
directly to the built binary.

build: fix error building html documentation from tarball

Reported by Egmont Koblinger <egmont@gmail.com> in
<https://lists.gnu.org/r/coreutils/2026-01/msg00111.html>.

* Makefile.am (EXTRA_DIST): Add build-aux/makeinfo-wrapper.sh.

tests: avoid a test hang on AIX

* init.cfg (uses_strace_): New function.
(require_strace_): Use it.
tests/cksum/cksum-c.sh: Likewise.
tests/misc/read-errors.sh: Likewise.

build: update gnulib submodule to latest

maint: remove sc_prohibit_NULL syntax check

* cfg.mk: NULL is fine and good in C as per:
https://bugs.gnu.org/66221#53

build: update gnulib submodule to latest