238 lines
5.8 KiB
Groff
238 lines
5.8 KiB
Groff
.\" $NetBSD: nl.1,v 1.11 2012/01/02 00:36:41 wiz Exp $
|
|
.\"
|
|
.\" Copyright (c) 1999 The NetBSD Foundation, Inc.
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" This code is derived from software contributed to The NetBSD Foundation
|
|
.\" by Klaus Klein.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
|
|
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
|
|
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
|
|
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
.\" POSSIBILITY OF SUCH DAMAGE.
|
|
.\"
|
|
.Dd February 15, 1999
|
|
.Dt NL 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm nl
|
|
.Nd line numbering filter
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl p
|
|
.Bk -words
|
|
.Op Fl b Ar type
|
|
.Ek
|
|
.Bk -words
|
|
.Op Fl d Ar delim
|
|
.Ek
|
|
.Bk -words
|
|
.Op Fl f Ar type
|
|
.Ek
|
|
.Bk -words
|
|
.Op Fl h Ar type
|
|
.Ek
|
|
.Bk -words
|
|
.Op Fl i Ar incr
|
|
.Ek
|
|
.Bk -words
|
|
.Op Fl l Ar num
|
|
.Ek
|
|
.Bk -words
|
|
.Op Fl n Ar format
|
|
.Ek
|
|
.Bk -words
|
|
.Op Fl s Ar sep
|
|
.Ek
|
|
.Bk -words
|
|
.Op Fl v Ar startnum
|
|
.Ek
|
|
.Bk -words
|
|
.Op Fl w Ar width
|
|
.Ek
|
|
.Op Ar file
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
utility reads lines from the named
|
|
.Ar file
|
|
or the standard input if the
|
|
.Ar file
|
|
argument is omitted,
|
|
applies a configurable line numbering filter operation and writes the result
|
|
to the standard output.
|
|
.Pp
|
|
The
|
|
.Nm
|
|
utility treats the text it reads in terms of logical pages.
|
|
Unless specified otherwise, line numbering is reset at the start of each
|
|
logical page.
|
|
A logical page consists of a header, a body and a footer section; empty
|
|
sections are valid.
|
|
Different line numbering options are independently available for header,
|
|
body and footer sections.
|
|
.Pp
|
|
The starts of logical page sections are signaled by input lines containing
|
|
nothing but one of the following sequences of delimiter characters:
|
|
.Pp
|
|
.Bd -unfilled -offset indent
|
|
.Bl -column "\e:\e:\e: " "header "
|
|
.It Em "Line" "Start of"
|
|
.It \e:\e:\e: header
|
|
.It \e:\e: body
|
|
.It \e: footer
|
|
.El
|
|
.Ed
|
|
.Pp
|
|
If the input does not contain any logical page section signaling directives,
|
|
the text being read is assumed to consist of a single logical page body.
|
|
.Pp
|
|
The following options are available:
|
|
.Bl -tag -width indent
|
|
.It Fl b Ar type
|
|
Specify the logical page body lines to be numbered.
|
|
Recognized
|
|
.Ar type
|
|
arguments are:
|
|
.Bl -tag -width pstringXX
|
|
.It a
|
|
Number all lines.
|
|
.It t
|
|
Number only non-empty lines.
|
|
.It n
|
|
No line numbering.
|
|
.It p Ns Ar expr
|
|
Number only those lines that contain the basic regular expression specified
|
|
by
|
|
.Ar expr .
|
|
.El
|
|
.Pp
|
|
The default
|
|
.Ar type
|
|
for logical page body lines is t.
|
|
.It Fl d Ar delim
|
|
Specify the delimiter characters used to indicate the start of a logical
|
|
page section in the input file.
|
|
At most two characters may be specified; if only one character is specified,
|
|
the first character is replaced and the second character remains unchanged.
|
|
The default
|
|
.Ar delim
|
|
characters are ``\e:''.
|
|
.It Fl f Ar type
|
|
Specify the same as
|
|
.Fl b Ar type
|
|
except for logical page footer lines.
|
|
The default
|
|
.Ar type
|
|
for logical page footer lines is n.
|
|
.It Fl h Ar type
|
|
Specify the same as
|
|
.Fl b Ar type
|
|
except for logical page header lines.
|
|
The default
|
|
.Ar type
|
|
for logical page header lines is n.
|
|
.It Fl i Ar incr
|
|
Specify the increment value used to number logical page lines.
|
|
The default
|
|
.Ar incr
|
|
value is 1.
|
|
.It Fl l Ar num
|
|
If numbering of all lines is specified for the current logical section
|
|
using the corresponding
|
|
.Fl b
|
|
a,
|
|
.Fl f
|
|
a
|
|
or
|
|
.Fl h
|
|
a
|
|
option,
|
|
specify the number of adjacent blank lines to be considered as one.
|
|
For example,
|
|
.Fl l
|
|
2 results in only the second adjacent blank line being numbered.
|
|
The default
|
|
.Ar num
|
|
value is 1.
|
|
.It Fl n Ar format
|
|
Specify the line numbering output format.
|
|
Recognized
|
|
.Ar format
|
|
arguments are:
|
|
.Bl -tag -width lnXX -compact
|
|
.It ln
|
|
Left justified.
|
|
.It rn
|
|
Right justified, leading zeros suppressed.
|
|
.It rz
|
|
Right justified, leading zeros kept.
|
|
.El
|
|
.Pp
|
|
The default
|
|
.Ar format
|
|
is rn.
|
|
.It Fl p
|
|
Specify that line numbering should not be restarted at logical page delimiters.
|
|
.It Fl s Ar sep
|
|
Specify the characters used in separating the line number and the corresponding
|
|
text line.
|
|
The default
|
|
.Ar sep
|
|
setting is a single tab character.
|
|
.It Fl v Ar startnum
|
|
Specify the initial value used to number logical page lines; see also the
|
|
description of the
|
|
.Fl p
|
|
option.
|
|
The default
|
|
.Ar startnum
|
|
value is 1.
|
|
.It Fl w Ar width
|
|
Specify the number of characters to be occupied by the line number;
|
|
in case the
|
|
.Ar width
|
|
is insufficient to hold the line number, it will be truncated to its
|
|
.Ar width
|
|
least significant digits.
|
|
The default
|
|
.Ar width
|
|
is 6.
|
|
.El
|
|
.Sh EXIT STATUS
|
|
The
|
|
.Nm
|
|
utility exits 0 on success, and \*[Gt]0 if an error occurs.
|
|
.Sh SEE ALSO
|
|
.Xr pr 1
|
|
.Sh STANDARDS
|
|
The
|
|
.Nm
|
|
utility conforms to
|
|
.St -xpg4.2
|
|
with the exception of not supporting the intermingling of the
|
|
.Ar file
|
|
operand with the options, which the standard considers an obsolescent feature
|
|
to be removed from a further issue.
|
|
.Sh HISTORY
|
|
The
|
|
.Nm
|
|
utility first appeared in
|
|
.At V.2 .
|