summaryrefslogtreecommitdiff
path: root/man/cut.1
blob: 1424029a226d30a12a697a336acfb36a8454042d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
.TH CUT "1" "March 2007" "GNU coreutils 6.9" "User Commands"
.SH NAME
cut \- remove sections from each line of files
.SH SYNOPSIS
.B cut
[\fIOPTION\fR]... [\fIFILE\fR]...
.SH DESCRIPTION
.\" Add any additional description here
.PP
Print selected parts of lines from each FILE to standard output.
.PP
Mandatory arguments to long options are mandatory for short options too.
.TP
\fB\-b\fR, \fB\-\-bytes\fR=\fILIST\fR
select only these bytes
.TP
\fB\-c\fR, \fB\-\-characters\fR=\fILIST\fR
select only these characters
.TP
\fB\-d\fR, \fB\-\-delimiter\fR=\fIDELIM\fR
use DELIM instead of TAB for field delimiter
.TP
\fB\-f\fR, \fB\-\-fields\fR=\fILIST\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=\fISTRING\fR
use STRING as the output delimiter
the default is to use the input delimiter
.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
.PP
With no FILE, or when FILE is \-, read standard input.
.SH AUTHOR
Written by David Ihnat, David MacKenzie, and Jim Meyering.
.SH "REPORTING BUGS"
Report bugs to <bug\-coreutils@gnu.org>.
.SH COPYRIGHT
Copyright \(co 2007 Free Software Foundation, Inc.
.br
This is free software.  You may redistribute copies of it under the terms of
the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
The full documentation for
.B cut
is maintained as a Texinfo manual.  If the
.B info
and
.B cut
programs are properly installed at your site, the command
.IP
.B info cut
.PP
should give you access to the complete manual.