]> git.ipfire.org Git - thirdparty/coreutils.git/commitdiff
doc: more indexing fixes in manual
authorPádraig Brady <P@draigBrady.com>
Tue, 20 Jan 2026 17:37:42 +0000 (17:37 +0000)
committerPádraig Brady <P@draigBrady.com>
Wed, 21 Jan 2026 13:51:58 +0000 (13:51 +0000)
* 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/coreutils.texi
src/pr.c
tests/split/line-bytes.sh

index fb628a3fb7078cb1fe15aaaa599e99b2aa532181..b31c49d05f798c4e0eb87383a7500d8fef5286fc 100644 (file)
@@ -2293,6 +2293,8 @@ The program accepts the following options.  Also see @ref{Common options}.
 
 @optAnchor{base32,-w}
 @optAnchor{base32,--wrap}
+@optAnchor{basenc,-w}
+@optAnchor{basenc,--wrap}
 @optItem{base64,-w,@w{ }@var{cols}}
 @optItemx{base64,--wrap,=@var{cols}}
 @cindex wrap data
@@ -2305,6 +2307,8 @@ disable line wrapping altogether.
 
 @optAnchor{base32,-d}
 @optAnchor{base32,--decode}
+@optAnchor{basenc,-d}
+@optAnchor{basenc,--decode}
 @optItem{base64,-d,}
 @optItemx{base64,--decode,}
 @cindex Decode base64 data
@@ -2315,6 +2319,8 @@ output will be the original data.
 
 @optAnchor{base32,-i}
 @optAnchor{base32,--ignore-garbage}
+@optAnchor{basenc,-i}
+@optAnchor{basenc,--ignore-garbage}
 @optItem{base64,-i,}
 @optItemx{base64,--ignore-garbage,}
 @cindex Ignore garbage in base64 stream
@@ -2628,6 +2634,7 @@ is identical.  By default, counting starts with the first page of input
 file (not first page printed).  Line numbering may be altered by @option{-N}
 option.
 
+@optAnchor{pr,-COLS}
 @optItem{pr,-@var{column},}
 @optItemx{pr,--columns,=@var{column}}
 @cindex down columns
@@ -3296,7 +3303,7 @@ Put @var{size} bytes of @var{input} into each output file.
 @multiplierSuffixes{size}
 
 @optItem{split,-C,@w{ }@var{size}}
-@optItemx{split,--lines-bytes,=@var{size}}
+@optItemx{split,--line-bytes,=@var{size}}
 Put into each output file as many complete lines of @var{input} as
 possible without exceeding @var{size} bytes.  Individual lines or records
 longer than @var{size} bytes are broken into multiple files.
@@ -5402,6 +5409,9 @@ Columns are separated by a single TAB character.
 @c FIXME: when there's an option to supply an alternative separator
 @c string, append "by default" to the above sentence.
 
+@optAnchor{comm,-1}
+@optAnchor{comm,-2}
+@optAnchor{comm,-3}
 @opindex -1
 @opindex -2
 @opindex -3
@@ -6308,7 +6318,7 @@ a       b       c
 @end example
 
 @optItem{paste,-d,@w{ }@var{delim-list}}
-@optItemx{paste,--delimiter,=@var{delim-list}}
+@optItemx{paste,--delimiters,=@var{delim-list}}
 Consecutively use the characters in @var{delim-list} instead of
 TAB to separate merged lines.  When @var{delim-list} is
 exhausted, start again at its beginning.
@@ -7319,7 +7329,7 @@ The program accepts the following options.  Also see @ref{Common options}.
 
 @table @samp
 
-@optItem{expand,@w{ }@var{tab1}[@comma{}@var{tab2}]@dots{},}
+@optItem{expand,-t,@w{ }@var{tab1}[@comma{}@var{tab2}]@dots{}}
 @optItemx{expand,--tabs,=@var{tab1}[@comma{}@var{tab2}]@dots{}}
 @cindex tab stops, setting
 If only one tab stop is given, set the tabs @var{tab1} spaces apart
@@ -7385,7 +7395,7 @@ The program accepts the following options.  Also see @ref{Common options}.
 
 @table @samp
 
-@optItem{unexpand,@w{ }@var{tab1}[@comma{}@var{tab2}]@dots{},}
+@optItem{unexpand,-t,@w{ }@var{tab1}[@comma{}@var{tab2}]@dots{}}
 @optItemx{unexpand,--tabs,=@var{tab1}[@comma{}@var{tab2}]@dots{}}
 If only one tab stop is given, set the tabs @var{tab1} columns apart
 instead of the default 8.  Otherwise, set the tabs at columns
@@ -11293,10 +11303,8 @@ Do not act on symbolic links themselves but rather on what they point to.
 This is the default when not operating recursively.
 @warnOptDerefWithRec
 
-@item -h
-@itemx --no-dereference
-@opindex -h
-@opindex --no-dereference
+@optItem{\cmd\,-h,}
+@optItemx{\cmd\,--no-dereference,}
 @cindex symbolic links, changing owner
 @findex lchown
 Act on symbolic links themselves instead of what they point to.
index d76a2c39f0ecef7ca66543c27cb4b2eadcd9188b..5694411674c51c18692d013edf63536093cc28b1 100644 (file)
--- a/src/pr.c
+++ b/src/pr.c
@@ -2777,11 +2777,13 @@ Paginate or columnate FILE(s) for printing.\n\
       fputs (_("\
   +FIRST_PAGE[:LAST_PAGE], --pages=FIRST_PAGE[:LAST_PAGE]\n\
          begin [stop] printing with page FIRST_[LAST_]PAGE\n\
-  -COLUMN, --columns=COLUMN\n\
-         output COLUMN columns and print columns down, unless -a is used.\n\
-         Balance number of lines in the columns on each page\n\
 "), stdout);
       oputs (_("\
+  -COLS, --columns=COLS\n\
+         output COLS columns and print columns down, unless -a is used.\n\
+         Balance number of lines in the columns on each page\n\
+"));
+      oputs (_("\
   -a, --across\n\
          print columns across rather than down, used together with -COLUMN\n\
 "));
index b03343c941f62bfc915dde273ed4cb5cec600804..2fbf1226d5524f9ed656454737acaabd76b1daca 100755 (executable)
@@ -1,5 +1,5 @@
 #!/bin/sh
-# test -C, --lines-bytes
+# test -C, --line-bytes
 
 # Copyright (C) 2013-2026 Free Software Foundation, Inc.
 
@@ -84,7 +84,7 @@ for b in $(seq 10); do
   compare no_eol_splits_exp no_eol_splits || fail=1
 done
 
-# Test hold buffer management with --lines-bytes.
+# Test hold buffer management with --line-bytes.
 # The following triggers (with ASAN) a heap overflow issue
 # between coreutils 9.2 and 9.4 inclusive.
 printf '%131070s\n' '' >expaa || framework_failure_