home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Frozen Fish 1: Amiga
/
FrozenFish-Apr94.iso
/
bbs
/
gnu
/
textutils-1.9-bin.lha
/
man
/
cat1
/
nl.0
< prev
next >
Wrap
Text File
|
1993-12-07
|
6KB
|
199 lines
NL(1L) NL(1L)
NNAAMMEE
nl - number lines of files
SSYYNNOOPPSSIISS
nnll [-h header-style] [-b body-style] [-f footer-style]
[-p] [-d cc] [-v start-number] [-i increment] [-l lines]
[-s line-separator] [-w line-no-width] [-n {ln,rn,rz}]
[--header-numbering=style] [--body-numbering=style]
[--footer-numbering=style] [--first-page=number] [--page-
increment=number] [--no-renumber] [--join-blank-
lines=number] [--number-separator=string] [--number-
width=number] [--number-format={ln,rn,rz}] [--section-
delimiter=cc] [--help] [--version] [file...]
DDEESSCCRRIIPPTTIIOONN
This manual page documents the GNU version of nnll. nnll
copies each given file, or the standard input if none are
given or when a file named `-' is given, to the standard
output, with line numbers added to some or all of the
lines.
nnll considers its input to be composed of logical pages; by
default, the line number is reset to 1 at the top of each
logical page. nnll treats all of the input files as a sin-
gle document; it does not reset line numbers or logical
pages between files.
A logical page consists of three sections: header, body,
and footer. Any of the sections can be empty. Each can
be numbered in a different style from the others.
The beginnings of the sections of logical pages are indi-
cated in the input file by a line containing nothing
except one of the delimiter strings shown below:
\:\:\: start of header
\:\: start of body
\: start of footer
The two characters from which these strings are made can
be changed with an option (see below), but the pattern and
length of each string cannot be changed.
The section delimiter strings are replaced by an empty
line on output. Any text that comes before the first sec-
tion delimiter string in the input file is considered to
be part of a body section, so a file that does not contain
any section delimiter strings is considered to consist of
a single body section.
OOPPTTIIOONNSS
_-_h_, _-_-_h_e_a_d_e_r_-_n_u_m_b_e_r_i_n_g_=_s_t_y_l_e
See --footer-numbering.
FSF GNU Text Utilities 1
NL(1L) NL(1L)
_-_b_, _-_-_b_o_d_y_-_n_u_m_b_e_r_i_n_g_=_s_t_y_l_e
See --footer-numbering.
_-_f_, _-_-_f_o_o_t_e_r_-_n_u_m_b_e_r_i_n_g_=_s_t_y_l_e
Select the numbering style for lines in the footer
section of each logical page. When a line is not
numbered, the current line number is not incre-
mented, but the line number separator character is
still prepended to the line. The styles are:
a number all lines
t number only nonempty lines (default for
body)
n number no lines (default for header and
footer)
p_r_e_g_e_x_p
number only lines that contain a match for
_r_e_g_e_x_p
_-_p_, _-_-_n_o_-_r_e_n_u_m_b_e_r
Do not reset the line number at the start of a log-
ical page.
_-_v_, _-_-_f_i_r_s_t_-_p_a_g_e_=_n_u_m_b_e_r
Set the initial line number on each logical page to
_n_u_m_b_e_r (default 1).
_-_i_, _-_-_p_a_g_e_-_i_n_c_r_e_m_e_n_t_=_n_u_m_b_e_r
Increment line numbers by _n_u_m_b_e_r (default 1).
_-_l_, _-_-_j_o_i_n_-_b_l_a_n_k_-_l_i_n_e_s_=_n_u_m_b_e_r
Consider _n_u_m_b_e_r (default 1) consecutive empty lines
to be one logical line for numbering, and only num-
ber the last one. Where fewer than _n_u_m_b_e_r consecu-
tive empty lines occur, do not number them. An
empty line is one that contains no characters, not
even spaces or tabs.
_-_s_, _-_-_n_u_m_b_e_r_-_s_e_p_a_r_a_t_o_r_=_s_t_r_i_n_g
Separate the line number from the text line in the
output with _s_t_r_i_n_g (default is a TAB character).
_-_w_, _-_-_n_u_m_b_e_r_-_w_i_d_t_h_=_n_u_m_b_e_r
Use _n_u_m_b_e_r characters for line numbers (default 6).
_-_n_, _-_-_n_u_m_b_e_r_-_f_o_r_m_a_t_=_{_l_n_,_r_n_,_r_z_}
Select the line numbering format:
ln left justified, no leading zeros
rn right justified, no leading zeros (default)
FSF GNU Text Utilities 2
NL(1L) NL(1L)
rz right justified, leading zeros
_-_d_, _-_-_s_e_c_t_i_o_n_-_d_e_l_i_m_i_t_e_r_=_c_c
Set the two delimiter characters that indicate the
beginnings of logical page sections; if only one is
given, the second remains ':'. To enter '\', use
'\\'.
_-_-_h_e_l_p Print a usage message and exit with a non-zero sta-
tus.
_-_-_v_e_r_s_i_o_n
Print version information on standard error then
exit.
FSF GNU Text Utilities 3