Tizen 2.0 Release
[external/tizen-coreutils.git] / man / nl.1
1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
2 .TH NL "1" "March 2007" "GNU coreutils 6.9" "User Commands"
3 .SH NAME
4 nl \- number lines of files
5 .SH SYNOPSIS
6 .B nl
7 [\fIOPTION\fR]... [\fIFILE\fR]...
8 .SH DESCRIPTION
9 .\" Add any additional description here
10 .PP
11 Write each FILE to standard output, with line numbers added.
12 With no FILE, or when FILE is \-, read standard input.
13 .PP
14 Mandatory arguments to long options are mandatory for short options too.
15 .TP
16 \fB\-b\fR, \fB\-\-body\-numbering\fR=\fISTYLE\fR
17 use STYLE for numbering body lines
18 .TP
19 \fB\-d\fR, \fB\-\-section\-delimiter\fR=\fICC\fR
20 use CC for separating logical pages
21 .TP
22 \fB\-f\fR, \fB\-\-footer\-numbering\fR=\fISTYLE\fR
23 use STYLE for numbering footer lines
24 .TP
25 \fB\-h\fR, \fB\-\-header\-numbering\fR=\fISTYLE\fR
26 use STYLE for numbering header lines
27 .TP
28 \fB\-i\fR, \fB\-\-page\-increment\fR=\fINUMBER\fR
29 line number increment at each line
30 .TP
31 \fB\-l\fR, \fB\-\-join\-blank\-lines\fR=\fINUMBER\fR
32 group of NUMBER empty lines counted as one
33 .TP
34 \fB\-n\fR, \fB\-\-number\-format\fR=\fIFORMAT\fR
35 insert line numbers according to FORMAT
36 .TP
37 \fB\-p\fR, \fB\-\-no\-renumber\fR
38 do not reset line numbers at logical pages
39 .TP
40 \fB\-s\fR, \fB\-\-number\-separator\fR=\fISTRING\fR
41 add STRING after (possible) line number
42 .TP
43 \fB\-v\fR, \fB\-\-first\-page\fR=\fINUMBER\fR
44 first line number on each logical page
45 .TP
46 \fB\-w\fR, \fB\-\-number\-width\fR=\fINUMBER\fR
47 use NUMBER columns for line numbers
48 .TP
49 \fB\-\-help\fR
50 display this help and exit
51 .TP
52 \fB\-\-version\fR
53 output version information and exit
54 .PP
55 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
56 two delimiter characters for separating logical pages, a missing
57 second character implies :.  Type \e\e for \e.  STYLE is one of:
58 .TP
59 a
60 number all lines
61 .TP
62 t
63 number only nonempty lines
64 .TP
65 n
66 number no lines
67 .TP
68 pBRE
69 number only lines that contain a match for the basic regular
70 expression, BRE
71 .PP
72 FORMAT is one of:
73 .TP
74 ln
75 left justified, no leading zeros
76 .TP
77 rn
78 right justified, no leading zeros
79 .TP
80 rz
81 right justified, leading zeros
82 .SH AUTHOR
83 Written by Scott Bartram and David MacKenzie.
84 .SH "REPORTING BUGS"
85 Report bugs to <bug\-coreutils@gnu.org>.
86 .SH COPYRIGHT
87 Copyright \(co 2007 Free Software Foundation, Inc.
88 .br
89 This is free software.  You may redistribute copies of it under the terms of
90 the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
91 There is NO WARRANTY, to the extent permitted by law.
92 .SH "SEE ALSO"
93 The full documentation for
94 .B nl
95 is maintained as a Texinfo manual.  If the
96 .B info
97 and
98 .B nl
99 programs are properly installed at your site, the command
100 .IP
101 .B info nl
102 .PP
103 should give you access to the complete manual.