version 1.1, 2013/09/08 18:59:07 |
version 1.2, 2013/09/08 20:23:34 |
|
|
.Nm |
.Nm |
utility reads lines from the named |
utility reads lines from the named |
.Ar file , |
.Ar file , |
applies a configurable line numbering filter operation and writes the result |
applies a configurable line numbering filter operation, |
to the standard output. |
and writes the result to the standard output. |
If |
If |
.Ar file |
.Ar file |
is a single dash |
is a single dash |
|
|
.Pp |
.Pp |
The starts of logical page sections are signaled by input lines containing |
The starts of logical page sections are signaled by input lines containing |
nothing but one of the following sequences of delimiter characters: |
nothing but one of the following sequences of delimiter characters: |
.Bd -unfilled -offset indent |
.Bl -column "\e:\e:\e: " "header " -offset indent |
.Bl -column "\e:\e:\e: " "header " |
.It Em "Line" Ta Em "Start of" |
.It Em "Line" "Start of" |
|
.It \e:\e:\e: header |
.It \e:\e:\e: header |
.It \e:\e: body |
.It \e:\e: body |
.It \e: footer |
.It \e: footer |
.El |
.El |
.Ed |
|
.Pp |
.Pp |
If the input does not contain any logical page section signaling directives, |
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. |
the text being read is assumed to consist of a single logical page body. |
|
|
Recognized |
Recognized |
.Ar format |
.Ar format |
arguments are: |
arguments are: |
.Bl -tag -width lnXX -compact |
.Pp |
|
.Bl -tag -width lnXX -compact -offset indent |
.It ln |
.It ln |
Left justified. |
Left justified. |
.It rn |
.It rn |
|
|
value is 1. |
value is 1. |
.It Fl w Ar width |
.It Fl w Ar width |
Specify the number of characters to be occupied by the line number; |
Specify the number of characters to be occupied by the line number; |
in case the |
if the |
.Ar width |
.Ar width |
is insufficient to hold the line number, it will be truncated to its |
is insufficient to hold the line number, it will be truncated to its |
.Ar width |
.Ar width |