aboutsummaryrefslogtreecommitdiff
path: root/man/cut.1
blob: a8be22644609d77f1c7c947cc6e39fb3d62c0b31 (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
89
90
91
92
93
94
95
96
97
.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md.
.TH CUT "1" "2026-07-28" "BNU 9.11" "BNU Commands"
.SH NAME
cut \- remove sections from each line of files
.SH SYNOPSIS
.B cut
\fI\,OPTION\/\fR... [\fI\,FILE\/\fR]...
.SH DESCRIPTION
.\" This page is derived from GNU Coreutils documentation.
This page documents BNU, an independent Bun implementation compatible with
GNU Coreutils 9.11.
.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
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-b'\fB\-b, \-\-bytes=\,LIST\fP\X'tty: link'\/\fR
select only these byte positions
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-c'\fB\-c, \-\-characters=\,LIST\fP\X'tty: link'\/\fR
select only these character positions
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut--complement'\fB\-\-complement\fP\X'tty: link'
complement the set of selected bytes, characters or fields
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-d'\fB\-d, \-\-delimiter=\,DELIM\fP\X'tty: link'\/\fR
use DELIM instead of TAB for field delimiter
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-f'\fB\-f, \-\-fields=\,LIST\fP\X'tty: link'\/\fR
select only these fields;  also print any line that contains
no delimiter character, unless the \fB\-s\fR option is specified
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-F'\fB\-F LIST\fP\X'tty: link'
like \fB\-f\fR, but also implies \fB\-w\fR and \fB\-O\fR ' '
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-n'\fB\-n, \-\-no\-partial\fP\X'tty: link'
with \fB\-b\fR, don't output partial multi\-byte characters
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-O'\fB\-O, \-\-output\-delimiter=\,STRING\fP\X'tty: link'\/\fR
use STRING as the output delimiter;
the default is to use the input delimiter
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-s'\fB\-s, \-\-only\-delimited\fP\X'tty: link'
do not print lines not containing delimiters
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-w'\fB\-w, \-\-whitespace\-delimited[=\,trimmed]\fP\X'tty: link'\/\fR
use a run of blank characters as the field delimiter;
with 'trimmed', ignore leading and trailing blanks
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-z'\fB\-z, \-\-zero\-terminated\fP\X'tty: link'
line delimiter is NUL, not newline
.TP
\X'tty: link https://www.gnu.org/software/coreutils/cut#cut--help'\fB\-\-help\fP\X'tty: link'
display this help and exit
.TP
\X'tty: link https://www.gnu.org/software/coreutils/cut#cut--version'\fB\-\-version\fP\X'tty: link'
output version information and exit
.PP
Use one, and only one of \fB\-b\fR, \fB\-c\fR, \fB\-f\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 AUTHORS
Upstream GNU Coreutils documentation authors:
Written by David M. Ihnat, David MacKenzie, and Jim Meyering.
.br
Adapted for BNU; the BNU implementation is independent.
.SH "REPORTING BUGS"
Report BNU bugs at <https://github.com/Soccera1/bnu/issues>.
.br
For upstream GNU Coreutils, see <https://www.gnu.org/software/coreutils/>.
.SH COPYRIGHT
Copyright \(co 2026 Free Software Foundation, Inc.
.br
This manual page was adapted for BNU in 2026.
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"
Upstream documentation <https://www.gnu.org/software/coreutils/cut>
.br
BNU documentation is available locally via: info \(aq(bnu) cut invocation\(aq