


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] [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 delimeter 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.



                                                                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)



                                                                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 delimeter characters that indicate  the
              beginnings of logical page sections; if only one is
              given, the second remains ':'.  To enter  '\',  use
              '\\'.

       The  long-named options can be introduced with `+' as well
       as `--', for compatibility with previous releases.   Even-
       tually  support  for  `+'  will  be removed, because it is
       incompatible with the POSIX.2 standard.













































                                                                3


