22921a859f
Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command.
103 lines
1.7 KiB
Groff
103 lines
1.7 KiB
Groff
.Dd 2015-10-08
|
|
.Dt NL 1
|
|
.Os sbase
|
|
.Sh NAME
|
|
.Nm nl
|
|
.Nd line numbering filter
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl p
|
|
.Op Fl b Ar type
|
|
.Op Fl d Ar delim
|
|
.Op Fl f Ar type
|
|
.Op Fl h Ar type
|
|
.Op Fl i Ar num
|
|
.Op Fl l Ar num
|
|
.Op Fl n Ar format
|
|
.Op Fl s Ar sep
|
|
.Op Fl v Ar num
|
|
.Op Fl w Ar num
|
|
.Op Ar file
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
reads lines from
|
|
.Ar file
|
|
and writes them to stdout, numbering non-empty lines.
|
|
If no
|
|
.Ar file
|
|
is given
|
|
.Nm
|
|
reads from stdin.
|
|
.Sh OPTIONS
|
|
.Bl -tag -width Ds
|
|
.It Fl p
|
|
Do not reset line number for logical pages.
|
|
.It Fl h Ar type | Fl b Ar type | Fl f Ar type
|
|
Define which lines to number in the head | body | footer section:
|
|
.Bl -tag -width pstringXX
|
|
.It a
|
|
All lines.
|
|
.It n
|
|
No lines.
|
|
.It t
|
|
Only non-empty lines.
|
|
This is the default.
|
|
.It p Ns Ar expr
|
|
Only lines matching
|
|
.Ar expr
|
|
according to
|
|
.Xr regex 7 .
|
|
.El
|
|
.It Fl d Ar delim
|
|
Set
|
|
.Ar delim
|
|
as the delimiter for logical pages.
|
|
If
|
|
.Ar delim
|
|
is only one character,
|
|
.Nm
|
|
appends ":" to it.
|
|
The default is "\e:".
|
|
.It Fl i Ar num
|
|
Set the increment between numbered lines to
|
|
.Ar num .
|
|
.It Fl l Ar num
|
|
Set the number of adjacent blank lines to be considered as one to
|
|
.Ar num .
|
|
The default is 1.
|
|
.It Fl n Ar format
|
|
Set the line number output
|
|
.Ar format
|
|
to one of:
|
|
.Bl -tag -width pstringXX
|
|
.It ln
|
|
Left justified.
|
|
.It rn
|
|
Right justified.
|
|
This is the default.
|
|
.It rz
|
|
Right justified with leading zeroes.
|
|
.El
|
|
.It Fl s Ar sep
|
|
Use
|
|
.Ar sep
|
|
to separate line numbers and lines.
|
|
The default is "\et".
|
|
.It Fl v Ar num
|
|
Start counting lines from
|
|
.Ar num .
|
|
The default is 1.
|
|
.It Fl w Ar num
|
|
Set the width of the line number to
|
|
.Ar num .
|
|
The default is 6.
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr pr 1
|
|
.Sh STANDARDS
|
|
The
|
|
.Nm
|
|
utility is compliant with the
|
|
.St -p1003.1-2013
|
|
specification.
|