


      NNNNLLLL((((1111))))                       ((((UUUUNNNNIIIIXXXX 5555....0000))))                      NNNNLLLL((((1111))))



      NNNNAAAAMMMMEEEE
           nl - line numbering filter

      SSSSYYYYNNNNTTTTAAAAXXXX
           nnnnllll [----hhhhtype] [----bbbbtype] [----fffftype] [----vvvvstart#] [----iiiiincr] [----pppp]
           [----llllnum] [----sssssep] [----wwwwwidth] [----nnnnformat] [----dddddelim] file

      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
           _N_l reads lines from the named _f_i_l_e or the standard input if
           no _f_i_l_e is named and reproduces the lines on the standard
           output.  Lines are numbered on the left in accordance with
           the command options in effect.

           _N_l views the text it reads in terms of logical pages.  Line
           numbering is reset at the start of each logical page.  A
           logical page consists of a header, a body, and a footer
           section.  Empty sections are valid.  Different line
           numbering options are independently available for header,
           body, and footer (e.g. no numbering of header and footer
           lines while numbering blank lines only in the body).

           The start of logical page sections are signaled by input
           lines containing nothing but the following delimiter
           character(s):

                     _L_i_n_e _c_o_n_t_e_n_t_s  _S_t_a_r_t _o_f

                     \:\:\:         header

                     \:\:           body

                     \:             footer

           Unless optioned otherwise, _n_l assumes the text being read is
           in a single logical page body.

           Command options may appear in any order and may be
           intermingled with an optional file name.  Only one file may
           be named.  The options are:

           ----bbbb_t_y_p_e    Specifies which logical page body lines are to be
                     numbered.  Recognized _t_y_p_e_s and their meaning are:
                     aaaa, number all lines; tttt, number lines with
                     printable text only; nnnn, no line numbering;
                     pppp_s_t_r_i_n_g, number only lines that contain the
                     regular expression specified in _s_t_r_i_n_g.  Default
                     _t_y_p_e for logical page body is tttt (text lines
                     numbered).

           ----hhhh_t_y_p_e    Same as ----bbbb_t_y_p_e except for header.  Default _t_y_p_e
                     for logical page header is nnnn (no lines numbered).




      Page 1                                                   (9010-E)






      NNNNLLLL((((1111))))                       ((((UUUUNNNNIIIIXXXX 5555....0000))))                      NNNNLLLL((((1111))))



           ----ffff_t_y_p_e    Same as ----bbbb_t_y_p_e except for footer.  Default for
                     logical page footer is nnnn (no lines numbered).

           ----pppp        Do not restart numbering at logical page
                     delimiters.

           ----vvvv_s_t_a_r_t#  _S_t_a_r_t# is the initial value used to number logical
                     page lines.  Default is 1111.

           ----iiii_i_n_c_r    _I_n_c_r is the increment value used to number logical
                     page lines.  Default is 1111.

           ----ssss_s_e_p     _S_e_p is the character(s) used in separating the
                     line number and the corresponding text line.
                     Default _s_e_p is a tab.

           ----wwww_w_i_d_t_h   _W_i_d_t_h is the number of characters to be used for
                     the line number.  Default _w_i_d_t_h is 6666.

           ----nnnn_f_o_r_m_a_t  _F_o_r_m_a_t is the line numbering format.  Recognized
                     values are:  llllnnnn, left justified, leading zeroes
                     supressed; rrrrnnnn, right justified, leading zeroes
                     supressed; rrrrzzzz, right justified, leading zeroes
                     kept.  Default _f_o_r_m_a_t is rrrrnnnn (right justified).

           ----llll_n_u_m     _N_u_m is the number of blank lines to be considered
                     as one.  For example, ----llll2222 results in only the
                     second adjacent blank being numbered (if the
                     appropriate ----hhhhaaaa, ----bbbbaaaa, and/or ----ffffaaaa option is set).
                     Default is 1111.

           ----dddd_x_x      The delimiter characters specifying the start of a
                     logical page section may be changed from the
                     default characters (\:) to two user specified
                     characters.  If only one character is entered, the
                     second character remains the default character
                     (:).  No space should appear between the ----dddd and
                     the delimiter characters.  To enter a backslash,
                     use two backslashes.

      EEEEXXXXAAAAMMMMPPPPLLLLEEEE
           The command:

                     nl -v10 -i10 -d!+ file1 file2

           will number files 1 and 2 starting at line number 10 with an
           increment of ten.  The logical page delimiters are !+.

      SSSSEEEEEEEE AAAALLLLSSSSOOOO
           pr(1).





      Page 2                                                   (9010-E)



