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

maint: pacify another gcc -Wzero-as-null-pointer-constant warning

* src/uptime.c (print_uptime): Add a timezone_t cast to zero. Don't use
nullptr since timezone_t is not a standardized and may be defined to
something other than a pointer.

maint: spelling fixes

build: update gnulib submodule to latest

maint: pacify gcc -Wzero-as-null-pointer-constant

* src/basenc.c (long_options):
* src/chcon.c (change_file_context):
* src/copy.c (is_ancestor):
* src/env.c (build_argv):
* src/expr.c (nomoreargs):
* src/factor.c (mp_no_factors):
* src/ls.c (long_options, main):
* src/selinux.c (defaultcon, restorecon_private):
* src/shred.c (dopass):
* src/shuf.c (long_opts):
* src/tac.c (output):
* src/test.c (term):
* src/uniq.c (check_file): Do not use ‘0’ as a null pointer
constant.  Although it is typically valid C, there are exceptions
(e.g., stdarg) and it a bit cleaner to be consistent.  This patch
uses NULL, not nullptr, as I have second thoughts about nullptr;
see <https://bugs.gnu.org/66221#53>.

build: fix link errors with multi-call binary and 'cksum' excluded

* src/local.mk (src_ls_LDADD, src_seq_LDADD, src_md5sum_LDADD)
(src_sha1sum_LDADD, src_sha224sum_LDADD, src_sha256sum_LDADD)
(src_sha384sum_LDADD, src_sha512sum_LDADD): Set to
$(src_cksum_LDADD).
Reported at https://github.com/coreutils/coreutils/issues/172

all: with multi-call binary, only process options for known names

Setup
  $ ln -nsf src/coreutils foo

Before
  $ ./foo; echo $?
  foo: unknown program ‘foo’
  Try './foo --help' for more information.
  1
  ./foo --version; echo $?
  coreutils (GNU coreutils) 9.9.172-01993
  0

After
  $ ./foo; echo $?
  coreutils: unknown program 'foo'
  1
  $ ./foo --version; echo $?
  coreutils: unknown program 'foo'
  1

* src/coreutils.c (main): Don't process options if
we don't know they're intended for the multi-call binary.
Otherwise `foo --version` would return true, even though
foo was symlinked to the multi-call binary, but not supported.
* tests/misc/coreutils.sh: Add test cases.
* NEWS: Mention the change in behavior.

doc: paste: give a CSV generation example

* doc/coreutils.texi (paste invocation): Provide an example
to comma separate data.

build: paste: fix build failure with C99

GCC 10.2 gave the following error:
"error: a label can only be part of a statement
 and a declaration is not a statement"

* src/fold.c (fold_file): Add a ";" to avoid C2X specific syntax.

maint: avoid syntax-check failure from previous commit

* src/copy-file-data.c (sparse_copy): Use nullptr instead of NULL.

cat: don’t treat copy_file_range EFBIG as fatal

* src/cat.c (copy_cat):
* src/copy-file-data.c (sparse_copy):
Don’t treat EFBIG as a reportable error from copy_file_range.
If the input is at EOF and the output position is 2**63 - 1,
copy_file_range (ifd, NULL, ofd, NULL, 2146435072, 0)
incorrectly fails with EFBIG.  Problem observed on Ubuntu 25.10
x86-64 with Linux kernel 6.17.0-8-generic #8-Ubuntu.
I am too lazy to report this kernel bug or add a coreutils test case.

build: update gnulib submodule to latest

cp: copy-file-data.c commentary fixes

* src/copy-file-data.c: Update commentary to match code better.

tests: ensure utilities correctly diagnose read errors

* tests/misc/read-errors.sh: Ensure each utility calls a
read system call as requested.  Not doing so (say by avoiding
reading from a directory) is a layering violation.
Also ensure we diagnose the particular error encountered.

fmt: correctly diagnose read errors

* src/fmt.c (fmt): Pass errno to error() so that
the particular error is diagnosed.
* NEWS: Mention the improvement.

paste: support multi-byte delimiters

* src/paste.c (collapse_escapes): This is the central --delimiters
parsing function, so adjust to handle multi-byte chars with
mcel_scanz().  Populate a delimiters length array to support
characters of differing lengths.
(paste_serial): Use the delimiters length array to output
the appropriate delimiter.
(paste_parallel): Likewise.
* tests/paste/multi-byte.sh: A new test.
* tests/local.mk: Reference the new test.
* NEWS: Mention the improvement.

tests: nice: ensure large values are clamped

* tests/nice/nice.sh: Ensure integers > UINTMAX_MAX are supported.
From https://github.com/coreutils/coreutils/pull/170

maint: ptx: place long options without short options after CHAR_MAX

* src/ptx.c (FORMAT_OPTION): New constant.
(long_options): Use FORMAT_OPTION instead of 10.
(main): Likewise.

tests: cksum: use more general strace syscall injection

* tests/cksum/cksum-c.sh: Match "read" with a regex
to match any of the read syscall variants.

tests: paste -d: test supported escape sequences

* tests/misc/paste.pl: Test all supported POSIX and GNU
backslash escape sequences.

doc: paste: add more detail on operation and options

* src/paste.c (usage): Mention how lines are processed
with and without the -s option.  Also mention that -d
supports backslash escapes.
* doc/coreutils.texi (paste invocation): Likewise.
Also detail the backslash escapes, noting which are non-POSIX.

maint: ptx: reuse octhexdigits macros instead of redefining them

* src/ptx.c: Include octhexdigits.h.
(HEXTOBIN, ISODIGIT, OCTTOBIN): Remove macros.
(unescape_string): Use the macros from octhexdigits.h instead of the
removed macros.

tests: date: test nested parenthesis comment handling

* tests/date/date.pl: Add test cases.
Suggested by Sylvestre Ledru.

doc: runcon: use more accurate synopsis format

* src/runcon.c (usage): Align synopsis with format
used in other commands.
* doc/coreutils.texi (runcon invocation): Likewise.

tests: cksum: ensure --check handles I/O errors

* tests/cksum/cksum-c.sh: Use strace to inject EIO upon read(),
and verify it's handled appropriately.
From https://github.com/coreutils/coreutils/pull/167

tests: cksum: ensure --check diagnoses read errors

* tests/misc/read-errors.sh: Add a test case.
Discussed in https://github.com/coreutils/coreutils/pull/167

build: support 'dist' and 'syntax-check' targets without libselinux

Following on from commit v9.8-60-g8ba47d09a ...
Without libselinux installed, runcon and chcon stub binaries
will not be built by default.  We separate these utilities out
to a separate "not built unless appropriate" class, so that
we can add these to EXTRA_MANS so that the 'check-x-vs-1'
target doesn't fail, and the 'dist' target includes
these man pages.

* build-aux/gen-lists-of-programs.sh: Separate out
build_if_appropriate_progs, and propagate that through
to no_install_progs_default which populates EXTRA_MANS.
* src/local.mk: Separate out build_if_appropriate__progs
for clarity and consistency.

build: update gnulib submodule to latest

* gnulib: Update to latest mainly to pull in selinux module fixes.
* NEWS: Mention the build fix to honor --with-selinux building
stub chcon and runcon binaries on systems without libselinux.

cksum: promptly diagnose write errors

* src/cksum.c (output_file, digest_check): Check if standard output has
it's error flag set after printing.
* tests/misc/write-errors.sh: Add a test case that would previously run
forever.
* NEWS: Mention the improvement. Reorder alphabetically.

maint: remove redundant processing in a test

* tests/misc/write-errors.sh: This was a no-op anyway
due to inadequate escaping.  Also document the escaping requirement.

du: promptly diagnose write errors

* src/du.c (print_size): Call write_error() if can't flush.
* tests/misc/write-errors.sh: Add a test case.
* NEWS: Mention the improvement.

wc: promptly diagnose write errors

* src/wc.c (write_counts): Call write_error() if any pending errors.
* tests/misc/write-errors.sh: Add a test case.
* NEWS: Mention the improvement.