diff options
author | Jim Meyering <jim@meyering.net> | 2004-12-04 14:23:48 +0000 |
---|---|---|
committer | Jim Meyering <jim@meyering.net> | 2004-12-04 14:23:48 +0000 |
commit | b4c28f911e5d04406c759711bf2eaab86874f574 (patch) | |
tree | 156bfe8f0638f1c914242d4677daaebfc18e3f02 /doc/coreutils.texi | |
parent | 7d4bd07095fa553d3553d1b1304bdc89c93c1aca (diff) | |
download | coreutils-b4c28f911e5d04406c759711bf2eaab86874f574.tar.xz |
(cut invocation): Say when --complement is useful.
Diffstat (limited to 'doc/coreutils.texi')
-rw-r--r-- | doc/coreutils.texi | 42 |
1 files changed, 25 insertions, 17 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi index 3e9a7d3c7..479953863 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -4485,32 +4485,32 @@ options}. @itemx --bytes=@var{byte-list} @opindex -b @opindex --bytes -Print only the bytes in positions listed in @var{byte-list}. Tabs and -backspaces are treated like any other character; they take up 1 byte. -If an output delimiter is specified, (see the description of -@option{--output-delimiter}), then output that string between -ranges of selected bytes. +Select for printing only the bytes in positions listed in +@var{byte-list}. Tabs and backspaces are treated like any other +character; they take up 1 byte. If an output delimiter is specified, +(see the description of @option{--output-delimiter}), then output that +string between ranges of selected bytes. @item -c @var{character-list} @itemx --characters=@var{character-list} @opindex -c @opindex --characters -Print only characters in positions listed in @var{character-list}. -The same as @option{-b} for now, but internationalization will change -that. Tabs and backspaces are treated like any other character; they -take up 1 character. -If an output delimiter is specified, (see the description of -@option{--output-delimiter}), then output that string between -ranges of selected bytes. +Select for printing only the characters in positions listed in +@var{character-list}. The same as @option{-b} for now, but +internationalization will change that. Tabs and backspaces are +treated like any other character; they take up 1 character. If an +output delimiter is specified, (see the description of +@option{--output-delimiter}), then output that string between ranges +of selected bytes. @item -f @var{field-list} @itemx --fields=@var{field-list} @opindex -f @opindex --fields -Print only the fields listed in @var{field-list}. Fields are -separated by a TAB character by default. -Also print any line that contains no delimiter character, unless -the @option{--only-delimited} (@option{-s}) option is specified +Select for printing only the fields listed in @var{field-list}. +Fields are separated by a TAB character by default. Also print any +line that contains no delimiter character, unless the +@option{--only-delimited} (@option{-s}) option is specified @item -d @var{input_delim_byte} @itemx --delimiter=@var{input_delim_byte} @@ -4530,7 +4530,7 @@ Do not split multi-byte characters (no-op for now). For @option{-f}, do not print lines that do not contain the field separator character. Normally, any line without a field separator is printed verbatim. -@itemx --output-delimiter=@var{output_delim_string} +@item --output-delimiter=@var{output_delim_string} @opindex --output-delimiter With @option{-f}, output fields are separated by @var{output_delim_string}. The default with @option{-f} is to use the input delimiter. @@ -4539,6 +4539,14 @@ character offsets (as opposed to ranges of fields), output @var{output_delim_string} between non-overlapping ranges of selected bytes. +@item --complement +@opindex --complement +This option is a GNU extension. +Select for printing the complement of the bytes, characters or fields +selected with the @option{-b}, @option{-c} or @option{-f} options. +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. @end table |