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 output then exit. FSF GNU Text Utilities 3 .