


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


