]> git.ipfire.org Git - thirdparty/coreutils.git/commitdiff
doc: cut: resintate and expand -d info
authorPádraig Brady <P@draigBrady.com>
Sat, 28 Mar 2026 09:12:39 +0000 (09:12 +0000)
committerPádraig Brady <P@draigBrady.com>
Sun, 5 Apr 2026 12:15:56 +0000 (13:15 +0100)
* 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.

doc/coreutils.texi

index cf2f5015bad04bf71d7b1bc721468a83d6d42b2d..4352711b4432fdbde4e07107d39e979cad743c3f 100644 (file)
@@ -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}.