home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / gnu / man / cat1 / nl.0 < prev    next >
Text File  |  1993-12-07  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4. NL(1L)                                                     NL(1L)
  5.  
  6.  
  7. NNAAMMEE
  8.        nl - number lines of files
  9.  
  10. SSYYNNOOPPSSIISS
  11.        nnll  [-h  header-style]  [-b  body-style] [-f footer-style]
  12.        [-p] [-d cc] [-v start-number] [-i increment]  [-l  lines]
  13.        [-s  line-separator]  [-w  line-no-width]  [-n {ln,rn,rz}]
  14.        [--header-numbering=style]        [--body-numbering=style]
  15.        [--footer-numbering=style]  [--first-page=number] [--page-
  16.        increment=number]      [--no-renumber]      [--join-blank-
  17.        lines=number]    [--number-separator=string]    [--number-
  18.        width=number]   [--number-format={ln,rn,rz}]   [--section-
  19.        delimiter=cc] [--help] [--version] [file...]
  20.  
  21. DDEESSCCRRIIPPTTIIOONN
  22.        This  manual  page  documents  the  GNU version of nnll.  nnll
  23.        copies each given file, or the standard input if none  are
  24.        given  or  when a file named `-' is given, to the standard
  25.        output, with line numbers added to  some  or  all  of  the
  26.        lines.
  27.  
  28.        nnll considers its input to be composed of logical pages; by
  29.        default, the line number is reset to 1 at the top of  each
  30.        logical  page.  nnll treats all of the input files as a sin-
  31.        gle document; it does not reset line  numbers  or  logical
  32.        pages between files.
  33.  
  34.        A  logical  page consists of three sections: header, body,
  35.        and footer.  Any of the sections can be empty.   Each  can
  36.        be numbered in a different style from the others.
  37.  
  38.        The  beginnings of the sections of logical pages are indi-
  39.        cated in the input  file  by  a  line  containing  nothing
  40.        except one of the delimiter strings shown below:
  41.  
  42.  
  43.        \:\:\: start of header
  44.        \:\: start of body
  45.        \: start of footer
  46.  
  47.        The  two  characters from which these strings are made can
  48.        be changed with an option (see below), but the pattern and
  49.        length of each string cannot be changed.
  50.  
  51.        The  section  delimiter  strings  are replaced by an empty
  52.        line on output.  Any text that comes before the first sec-
  53.        tion  delimiter  string in the input file is considered to
  54.        be part of a body section, so a file that does not contain
  55.        any  section delimiter strings is considered to consist of
  56.        a single body section.
  57.  
  58.    OOPPTTIIOONNSS
  59.        _-_h_, _-_-_h_e_a_d_e_r_-_n_u_m_b_e_r_i_n_g_=_s_t_y_l_e
  60.               See --footer-numbering.
  61.  
  62.  
  63.  
  64. FSF                     GNU Text Utilities                      1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. NL(1L)                                                     NL(1L)
  71.  
  72.  
  73.        _-_b_, _-_-_b_o_d_y_-_n_u_m_b_e_r_i_n_g_=_s_t_y_l_e
  74.               See --footer-numbering.
  75.  
  76.        _-_f_, _-_-_f_o_o_t_e_r_-_n_u_m_b_e_r_i_n_g_=_s_t_y_l_e
  77.               Select the numbering style for lines in the  footer
  78.               section  of  each logical page.  When a line is not
  79.               numbered, the current line  number  is  not  incre-
  80.               mented,  but the line number separator character is
  81.               still prepended to the line.  The styles are:
  82.  
  83.               a      number all lines
  84.  
  85.               t      number  only  nonempty  lines  (default  for
  86.                      body)
  87.  
  88.               n      number  no  lines  (default  for  header and
  89.                      footer)
  90.  
  91.               p_r_e_g_e_x_p
  92.                      number only lines that contain a  match  for
  93.                      _r_e_g_e_x_p
  94.  
  95.        _-_p_, _-_-_n_o_-_r_e_n_u_m_b_e_r
  96.               Do not reset the line number at the start of a log-
  97.               ical page.
  98.  
  99.        _-_v_, _-_-_f_i_r_s_t_-_p_a_g_e_=_n_u_m_b_e_r
  100.               Set the initial line number on each logical page to
  101.               _n_u_m_b_e_r (default 1).
  102.  
  103.        _-_i_, _-_-_p_a_g_e_-_i_n_c_r_e_m_e_n_t_=_n_u_m_b_e_r
  104.               Increment line numbers by _n_u_m_b_e_r (default 1).
  105.  
  106.        _-_l_, _-_-_j_o_i_n_-_b_l_a_n_k_-_l_i_n_e_s_=_n_u_m_b_e_r
  107.               Consider _n_u_m_b_e_r (default 1) consecutive empty lines
  108.               to be one logical line for numbering, and only num-
  109.               ber the last one.  Where fewer than _n_u_m_b_e_r consecu-
  110.               tive empty lines occur, do  not  number  them.   An
  111.               empty  line is one that contains no characters, not
  112.               even spaces or tabs.
  113.  
  114.        _-_s_, _-_-_n_u_m_b_e_r_-_s_e_p_a_r_a_t_o_r_=_s_t_r_i_n_g
  115.               Separate the line number from the text line in  the
  116.               output with _s_t_r_i_n_g (default is a TAB character).
  117.  
  118.        _-_w_, _-_-_n_u_m_b_e_r_-_w_i_d_t_h_=_n_u_m_b_e_r
  119.               Use _n_u_m_b_e_r characters for line numbers (default 6).
  120.  
  121.        _-_n_, _-_-_n_u_m_b_e_r_-_f_o_r_m_a_t_=_{_l_n_,_r_n_,_r_z_}
  122.               Select the line numbering format:
  123.  
  124.               ln     left justified, no leading zeros
  125.  
  126.               rn     right justified, no leading zeros (default)
  127.  
  128.  
  129.  
  130. FSF                     GNU Text Utilities                      2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. NL(1L)                                                     NL(1L)
  137.  
  138.  
  139.               rz     right justified, leading zeros
  140.  
  141.        _-_d_, _-_-_s_e_c_t_i_o_n_-_d_e_l_i_m_i_t_e_r_=_c_c
  142.               Set the two delimiter characters that indicate  the
  143.               beginnings of logical page sections; if only one is
  144.               given, the second remains ':'.  To enter  '\',  use
  145.               '\\'.
  146.  
  147.        _-_-_h_e_l_p Print a usage message and exit with a non-zero sta-
  148.               tus.
  149.  
  150.        _-_-_v_e_r_s_i_o_n
  151.               Print version information on  standard  error  then
  152.               exit.
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. FSF                     GNU Text Utilities                      3
  197.  
  198.  
  199.