.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH NL 1 "2026-09-01"
.SH NAME
nl \- Number lines of files
.SH SYNOPSIS
\fBnl\fR [OPTION]... [FILE]...
.SH DESCRIPTION
Number lines of files
.SH OPTIONS
.TP
\fB\-\-help\fR
Print help information.
.TP
\fB\-b\fR, \fB\-\-body\-numbering\fR \fI<STYLE>\fR
use STYLE for numbering body lines
.TP
\fB\-d\fR, \fB\-\-section\-delimiter\fR \fI<CC>\fR
use CC for separating logical pages
.TP
\fB\-f\fR, \fB\-\-footer\-numbering\fR \fI<STYLE>\fR
use STYLE for numbering footer lines
.TP
\fB\-h\fR, \fB\-\-header\-numbering\fR \fI<STYLE>\fR
use STYLE for numbering header lines
.TP
\fB\-i\fR, \fB\-\-line\-increment\fR \fI<NUMBER>\fR
line number increment at each line
.TP
\fB\-l\fR, \fB\-\-join\-blank\-lines\fR \fI<NUMBER>\fR
group of NUMBER empty lines counted as one
.TP
\fB\-n\fR, \fB\-\-number\-format\fR \fI<FORMAT>\fR
insert line numbers according to FORMAT

\fIPossible values:\fR
.RS 14
.IP \(bu 2
ln
.IP \(bu 2
rn
.IP \(bu 2
rz
.RE
.TP
\fB\-p\fR, \fB\-\-no\-renumber\fR
do not reset line numbers at logical pages
.TP
\fB\-s\fR, \fB\-\-number\-separator\fR \fI<STRING>\fR
add STRING after (possible) line number
.TP
\fB\-v\fR, \fB\-\-starting\-line\-number\fR \fI<NUMBER>\fR
first line number on each logical page
.TP
\fB\-w\fR, \fB\-\-number\-width\fR \fI<NUMBER>\fR
use NUMBER columns for line numbers
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version
.SH EXTRA
STYLE is one of:

  \- a number all lines
  \- t number only nonempty lines
  \- n number no lines
  \- pBRE number only lines that contain a match for the basic regular expression, BRE

FORMAT is one of:

  \- ln left justified, no leading zeros
  \- rn right justified, no leading zeros
  \- rz right justified, leading zeros
.SH VERSION
v(uutils coreutils) 0.11.0