summaryrefslogtreecommitdiff
path: root/man/nl.1
blob: ffaf172df1cdb83777ac4517cd0fc58da3bf827e (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
98
99
100
101
102
103
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
.TH NL "1" "March 2007" "GNU coreutils 6.9" "User Commands"
.SH NAME
nl \- number lines of files
.SH SYNOPSIS
.B nl
[\fIOPTION\fR]... [\fIFILE\fR]...
.SH DESCRIPTION
.\" Add any additional description here
.PP
Write each FILE to standard output, with line numbers added.
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\-\-body\-numbering\fR=\fISTYLE\fR
use STYLE for numbering body lines
.TP
\fB\-d\fR, \fB\-\-section\-delimiter\fR=\fICC\fR
use CC for separating logical pages
.TP
\fB\-f\fR, \fB\-\-footer\-numbering\fR=\fISTYLE\fR
use STYLE for numbering footer lines
.TP
\fB\-h\fR, \fB\-\-header\-numbering\fR=\fISTYLE\fR
use STYLE for numbering header lines
.TP
\fB\-i\fR, \fB\-\-page\-increment\fR=\fINUMBER\fR
line number increment at each line
.TP
\fB\-l\fR, \fB\-\-join\-blank\-lines\fR=\fINUMBER\fR
group of NUMBER empty lines counted as one
.TP
\fB\-n\fR, \fB\-\-number\-format\fR=\fIFORMAT\fR
insert line numbers according to FORMAT
.TP
\fB\-p\fR, \fB\-\-no\-renumber\fR
do not reset line numbers at logical pages
.TP
\fB\-s\fR, \fB\-\-number\-separator\fR=\fISTRING\fR
add STRING after (possible) line number
.TP
\fB\-v\fR, \fB\-\-first\-page\fR=\fINUMBER\fR
first line number on each logical page
.TP
\fB\-w\fR, \fB\-\-number\-width\fR=\fINUMBER\fR
use NUMBER columns for line numbers
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.PP
By default, selects \fB\-v1\fR \fB\-i1\fR \fB\-l1\fR \fB\-sTAB\fR \fB\-w6\fR \fB\-nrn\fR \fB\-hn\fR \fB\-bt\fR \fB\-fn\fR.  CC are
two delimiter characters for separating logical pages, a missing
second character implies :.  Type \e\e for \e.  STYLE is one of:
.TP
a
number all lines
.TP
t
number only nonempty lines
.TP
n
number no lines
.TP
pBRE
number only lines that contain a match for the basic regular
expression, BRE
.PP
FORMAT is one of:
.TP
ln
left justified, no leading zeros
.TP
rn
right justified, no leading zeros
.TP
rz
right justified, leading zeros
.SH AUTHOR
Written by Scott Bartram and David MacKenzie.
.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 nl
is maintained as a Texinfo manual.  If the
.B info
and
.B nl
programs are properly installed at your site, the command
.IP
.B info nl
.PP
should give you access to the complete manual.