sbase/nl.1

120 lines
2.2 KiB
Groff
Raw Permalink Normal View History

2020-05-15 05:27:12 -04:00
.Dd 2020-05-15
.Dt NL 1
.Os sbase
2014-12-04 08:49:07 -05:00
.Sh NAME
.Nm nl
.Nd line numbering filter
.Sh SYNOPSIS
.Nm
2015-03-18 12:58:09 -04:00
.Op Fl p
2014-12-04 08:49:07 -05:00
.Op Fl b Ar type
2015-03-18 12:58:09 -04:00
.Op Fl d Ar delim
.Op Fl f Ar type
.Op Fl h Ar type
.Op Fl i Ar num
2015-03-10 07:49:56 -04:00
.Op Fl l Ar num
2015-02-20 09:12:03 -05:00
.Op Fl n Ar format
2014-12-04 08:49:07 -05:00
.Op Fl s Ar sep
.Op Fl v Ar num
.Op Fl w Ar num
2014-12-04 08:49:07 -05:00
.Op Ar file
.Sh DESCRIPTION
.Nm
reads lines from
2014-12-04 08:49:07 -05:00
.Ar file
and writes them to stdout, numbering non-empty lines.
If no
.Ar file
is given
2014-12-04 08:49:07 -05:00
.Nm
reads from stdin.
2020-05-15 05:27:12 -04:00
.Pp
.Nm
treats the input text as a collection of logical pages divided into
logical page sections.
Each logical page consists of a header section, a body
section and a footer section.
Sections may be empty.
The start of each section is indicated by a single delimiting line, one of:
.Bl -column "\e:\e:\e: " "header " -offset indent
.It Em "Line" Ta Em "Start of"
.It \e:\e:\e: header
.It \e:\e: body
.It \e: footer
.El
.Pp
If the input text contains no delimiting line then all of the input text
belongs to a single logical page body section.
2014-12-04 08:49:07 -05:00
.Sh OPTIONS
.Bl -tag -width Ds
2015-03-18 12:58:09 -04:00
.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:
2014-12-04 08:49:07 -05:00
.Bl -tag -width pstringXX
.It a
All lines.
.It n
No lines.
.It t
Only non-empty lines.
This is the default.
2014-12-04 08:49:07 -05:00
.It p Ns Ar expr
Only lines matching
.Ar expr
according to
2015-02-01 14:52:28 -05:00
.Xr regex 7 .
2014-12-04 08:49:07 -05:00
.El
2015-03-18 12:58:09 -04:00
.It Fl d Ar delim
Set
.Ar delim
as the delimiter for logical pages.
If
.Ar delim
2015-03-22 12:25:11 -04:00
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 .
2015-03-10 07:49:56 -04:00
.It Fl l Ar num
Set the number of adjacent blank lines to be considered as one to
.Ar num .
The default is 1.
2015-02-20 09:12:03 -05:00
.It Fl n Ar format
Set the line number output
2015-02-20 09:12:03 -05:00
.Ar format
to one of:
2015-02-20 09:12:03 -05:00
.Bl -tag -width pstringXX
.It ln
Left justified.
.It rn
Right justified.
This is the default.
2015-02-20 09:12:03 -05:00
.It rz
Right justified with leading zeroes.
.El
2014-12-04 08:49:07 -05:00
.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 .
2015-02-20 07:15:43 -05:00
The default is 6.
2014-12-04 08:49:07 -05:00
.El
.Sh SEE ALSO
.Xr pr 1
2015-03-18 12:58:09 -04:00
.Sh STANDARDS
The
.Nm
utility is compliant with the
.St -p1003.1-2013
2015-03-18 12:58:09 -04:00
specification.