]> git.ipfire.org Git - thirdparty/coreutils.git/commitdiff
doc: cut: document the -w option
authorPádraig Brady <P@draigBrady.com>
Fri, 20 Mar 2026 17:07:18 +0000 (17:07 +0000)
committerPádraig Brady <P@draigBrady.com>
Sun, 5 Apr 2026 12:15:56 +0000 (13:15 +0100)
* src/cut.c (usage): Mention blank characters are used to separate.
* doc/coreutils.texi (cut invocation): Likewise.  Also describe
the 'trimmed' argument and the relation to -F.

doc/coreutils.texi
src/cut.c

index 14ba21ab931c4a1ea202c691e7575d9c30f58c26..bee084707e595819a403c8618f29326eec896278 100644 (file)
@@ -6234,6 +6234,13 @@ character offsets (as opposed to ranges of fields),
 output @var{output_delim_string} between non-overlapping
 ranges of selected bytes.
 
+@optItem{cut,-w,}
+@optItemx{cut,--whitespace-delimited,[=trimmed]}
+With @option{-f}, separate fields with a run of blank characters
+(usually space or TAB).  With @samp{trimmed} do not consider
+leading and trailing blanks as field separators.
+@option{-w} is implied with the @option{-F} option.
+
 @optZeroTerminated{cut}
 
 @end table
index 4c25eddee8d3cff99ec9cd57e8a50ccf212378c2..9d50cee225791d21480f3ee51713a98fb9094e38 100644 (file)
--- a/src/cut.c
+++ b/src/cut.c
@@ -230,8 +230,8 @@ Print selected parts of lines from each FILE to standard output.\n\
 "));
       oputs (_("\
   -w, --whitespace-delimited[=trimmed]\n\
-         use runs of whitespace as the field delimiter;\n\
-         with 'trimmed', ignore leading and trailing whitespace\n\
+         use a run of blank characters as the field delimiter;\n\
+         with 'trimmed', ignore leading and trailing blanks\n\
 "));
       oputs (_("\
   -z, --zero-terminated\n\