From: Pádraig Brady <P@draigBrady.com>
Date: Sat, 28 Mar 2026 09:12:39 +0000 (+0000)
Subject: doc: cut: resintate and expand -d info
X-Git-Tag: v9.11~77
X-Git-Url: http://git.ipfire.org/gitweb/?a=commitdiff_plain;h=c3e819fadc62315e407cc5cf61cb4c81a0e14841;p=thirdparty%2Fcoreutils.git

doc: cut: resintate and expand -d info

* doc/coreutils.texi (cut invocation): Add back the -d description,
and adjust for multi-byte support, and expand on specifying a NUL
delimitier, and detail the behavior when the delimiter matches
the line delimiter.
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index cf2f5015ba..4352711b44 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -6177,6 +6177,17 @@ In other words, do @emph{not} print the bytes, characters or fields
 specified via those options.  This option is useful when you have
 many fields and want to print all but a few of them.
 
+@optItem{cut,-d,@w{ }@var{character}}
+@optItemx{cut,--delimiter,=@var{character}}
+With @option{-f}, use @var{character} as
+the input field separator (default is TAB).
+If an empty delimiter @var{character} is specified then the ASCII NUL
+character is used to delimit the fields.
+Note the delimiter @var{character} can be the same as the
+line terminator character, which can be used to select ranges of lines.
+In this case the last line terminator in the input is not treated
+as a field separator, which is significant with the @option{-s} option.
+
 @optItem{cut,-f,@w{ }@var{field-list}}
 @optItemx{cut,--fields,=@var{field-list}}
 Select for printing only the fields listed in @var{field-list}.