Blob Blame History Raw
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
.TH CUT "1" "July 2018" "GNU coreutils 8.30" "User Commands"
.SH NAME
cut \- remove sections from each line of files
.SH SYNOPSIS
.B cut
\fI\,OPTION\/\fR... [\fI\,FILE\/\fR]...
.SH DESCRIPTION
.\" Add any additional description here
.PP
Print selected parts of lines from each FILE to standard output.
.PP
With no FILE, or when FILE is \-, read standard input.
.PP
Mandatory arguments to long options are mandatory for short options too.
.TP
\fB\-b\fR, \fB\-\-bytes\fR=\fI\,LIST\/\fR
select only these bytes
.TP
\fB\-c\fR, \fB\-\-characters\fR=\fI\,LIST\/\fR
select only these characters
.TP
\fB\-d\fR, \fB\-\-delimiter\fR=\fI\,DELIM\/\fR
use DELIM instead of TAB for field delimiter
.TP
\fB\-f\fR, \fB\-\-fields\fR=\fI\,LIST\/\fR
select only these fields;  also print any line
that contains no delimiter character, unless
the \fB\-s\fR option is specified
.TP
\fB\-n\fR
(ignored)
.TP
\fB\-\-complement\fR
complement the set of selected bytes, characters
or fields
.TP
\fB\-s\fR, \fB\-\-only\-delimited\fR
do not print lines not containing delimiters
.TP
\fB\-\-output\-delimiter\fR=\fI\,STRING\/\fR
use STRING as the output delimiter
the default is to use the input delimiter
.TP
\fB\-z\fR, \fB\-\-zero\-terminated\fR
line delimiter is NUL, not newline
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.PP
Use one, and only one of \fB\-b\fR, \fB\-c\fR or \fB\-f\fR.  Each LIST is made up of one
range, or many ranges separated by commas.  Selected input is written
in the same order that it is read, and is written exactly once.
Each range is one of:
.TP
N
N'th byte, character or field, counted from 1
.TP
N\-
from N'th byte, character or field, to end of line
.TP
N\-M
from N'th to M'th (included) byte, character or field
.TP
\fB\-M\fR
from first to M'th (included) byte, character or field
.SH AUTHOR
Written by David M. Ihnat, David MacKenzie, and Jim Meyering.
.SH "REPORTING BUGS"
GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
.br
Report cut translation bugs to <https://translationproject.org/team/>
.SH COPYRIGHT
Copyright \(co 2018 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
Full documentation at: <https://www.gnu.org/software/coreutils/cut>
.br
or available locally via: info \(aq(coreutils) cut invocation\(aq