| .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. |