home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / misc / textutil.lha / textutils-1.3 / cat / nl.1 < prev    next >
Encoding:
Text File  |  1992-09-22  |  5.3 KB  |  199 lines
  1.  
  2.  
  3.  
  4. NL(1L)            MISC. REFERENCE MANUAL PAGES             NL(1L)
  5.  
  6.  
  7.  
  8. NAME
  9.      nl - number lines of files
  10.  
  11. SYNOPSIS
  12.      nl [-h header-style] [-b body-style] [-f footer-style]  [-p]
  13.      [-d  cc]  [-v  start-number]  [-i  increment] [-l lines] [-s
  14.      line-separator]   [-w   line-no-width]    [-n    {ln,rn,rz}]
  15.      [--header-numbering=style]          [--body-numbering=style]
  16.      [--footer-numbering=style]  [--first-page=number]   [--page-
  17.      increment=number]       [--no-renumber]       [--join-blank-
  18.      lines=number]     [--number-separator=string]     [--number-
  19.      width=number]    [--number-format={ln,rn,rz}]    [--section-
  20.      delimiter=cc] [file...]
  21.  
  22. DESCRIPTION
  23.      This manual page documents the GNU version of nl.  nl copies
  24.      each  given file, or the standard input if none are given or
  25.      when a file named `-' is given, to the standard output, with
  26.      line numbers added to some or all of the lines.
  27.  
  28.      nl 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.  nl treats all of the input files as a  single
  31.      document;  it  does  not reset line numbers or logical pages
  32.      between files.
  33.  
  34.      A logical page consists of three sections: header, body, and
  35.      footer.  Any of the sections can be empty.  Each can be num-
  36.      bered 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 except
  40.      one of the delimeter strings shown below:
  41.  
  42.      \:\:\: start of header
  43.      \:\: start of body
  44.      \: start of footer
  45.  
  46.      The two characters from which these strings are made can  be
  47.      changed  with  an  option  (see  below), but the pattern and
  48.      length of each string cannot be changed.
  49.  
  50.      The section delimiter strings are replaced by an empty  line
  51.      on  output.   Any  text  that comes before the first section
  52.      delimiter string in the input file is considered to be  part
  53.      of  a body section, so a file that does not contain any sec-
  54.      tion delimiter strings is considered to consist of a  single
  55.      body section.
  56.  
  57.   OPTIONS
  58.      -_h, --_h_e_a_d_e_r-_n_u_m_b_e_r_i_n_g=_s_t_y_l_e
  59.           See --footer-numbering.
  60.  
  61.  
  62.  
  63. Sun Release 4.1           Last change:                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. NL(1L)            MISC. REFERENCE MANUAL PAGES             NL(1L)
  71.  
  72.  
  73.  
  74.      -_b, --_b_o_d_y-_n_u_m_b_e_r_i_n_g=_s_t_y_l_e
  75.           See --footer-numbering.
  76.  
  77.      -_f, --_f_o_o_t_e_r-_n_u_m_b_e_r_i_n_g=_s_t_y_l_e
  78.           Select the numbering style for lines in the footer sec-
  79.           tion  of  each  logical  page.  When a line is not num-
  80.           bered, the current line number is not incremented,  but
  81.           the  line number separator character is still prepended
  82.           to the line.  The styles are:
  83.  
  84.           a    number all lines
  85.  
  86.           t    number only nonempty lines (default for body)
  87.  
  88.           n    number no lines (default for header and footer)
  89.  
  90.           p_r_e_g_e_x_p
  91.                number only lines that contain a match for _r_e_g_e_x_p
  92.  
  93.      -_p, --_n_o-_r_e_n_u_m_b_e_r
  94.           Do not reset the line number at the start of a  logical
  95.           page.
  96.  
  97.      -_v, --_f_i_r_s_t-_p_a_g_e=_n_u_m_b_e_r
  98.           Set the initial line number on  each  logical  page  to
  99.           _n_u_m_b_e_r (default 1).
  100.  
  101.      -_i, --_p_a_g_e-_i_n_c_r_e_m_e_n_t=_n_u_m_b_e_r
  102.           Increment line numbers by _n_u_m_b_e_r (default 1).
  103.  
  104.      -_l, --_j_o_i_n-_b_l_a_n_k-_l_i_n_e_s=_n_u_m_b_e_r
  105.           Consider _n_u_m_b_e_r (default 1) consecutive empty lines  to
  106.           be  one logical line for numbering, and only number the
  107.           last one.  Where fewer than  _n_u_m_b_e_r  consecutive  empty
  108.           lines  occur, do not number them.  An empty line is one
  109.           that contains no characters, not even spaces or tabs.
  110.  
  111.      -_s, --_n_u_m_b_e_r-_s_e_p_a_r_a_t_o_r=_s_t_r_i_n_g
  112.           Separate the line number from the text line in the out-
  113.           put with _s_t_r_i_n_g (default is a TAB character).
  114.  
  115.      -_w, --_n_u_m_b_e_r-_w_i_d_t_h=_n_u_m_b_e_r
  116.           Use _n_u_m_b_e_r characters for line numbers (default 6).
  117.  
  118.      -_n, --_n_u_m_b_e_r-_f_o_r_m_a_t={_l_n,_r_n,_r_z}
  119.           Select the line numbering format:
  120.  
  121.           ln   left justified, no leading zeros
  122.  
  123.           rn   right justified, no leading zeros (default)
  124.  
  125.           rz   right justified, leading zeros
  126.  
  127.  
  128.  
  129. Sun Release 4.1           Last change:                          2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. NL(1L)            MISC. REFERENCE MANUAL PAGES             NL(1L)
  137.  
  138.  
  139.  
  140.      -_d, --_s_e_c_t_i_o_n-_d_e_l_i_m_i_t_e_r=_c_c
  141.           Set the two  delimeter  characters  that  indicate  the
  142.           beginnings  of  logical  page  sections; if only one is
  143.           given, the second remains ':'.  To enter '\', use '\\'.
  144.  
  145.      The long-named options can be introduced with `+' as well as
  146.      `--',  for compatibility with previous releases.  Eventually
  147.      support for `+' will be removed, because it is  incompatible
  148.      with the POSIX.2 standard.
  149.  
  150.  
  151.  
  152.  
  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. Sun Release 4.1           Last change:                          3
  196.  
  197.  
  198.  
  199.