OSDN Git Service

e96312be548edabee1a722d0769795469e91a332
[linuxjm/coreutils.git] / original / man1 / nl.1
1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
2 .TH NL "1" "April 2010" "GNU coreutils 8.5" "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\-\-line\-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\-\-starting\-line\-number\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 nl bugs to bug\-coreutils@gnu.org
86 .br
87 GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
88 .br
89 General help using GNU software: <http://www.gnu.org/gethelp/>
90 .br
91 Report nl translation bugs to <http://translationproject.org/team/>
92 .SH COPYRIGHT
93 Copyright \(co 2010 Free Software Foundation, Inc.
94 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
95 .br
96 This is free software: you are free to change and redistribute it.
97 There is NO WARRANTY, to the extent permitted by law.
98 .SH "SEE ALSO"
99 The full documentation for
100 .B nl
101 is maintained as a Texinfo manual.  If the
102 .B info
103 and
104 .B nl
105 programs are properly installed at your site, the command
106 .IP
107 .B info coreutils \(aqnl invocation\(aq
108 .PP
109 should give you access to the complete manual.