home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / unix / doc / nl.man < prev    next >
Text File  |  1993-06-13  |  5KB  |  199 lines
  1.  
  2.  
  3.  
  4. NL(1L)                                                     NL(1L)
  5.  
  6.  
  7. NAME
  8.        nl - number lines of files
  9.  
  10. SYNOPSIS
  11.        nl  [-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. DESCRIPTION
  22.        This  manual  page  documents  the  GNU version of nl.  nl
  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.        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 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.    OPTIONS
  59.        -h, --header-numbering=style
  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, --body-numbering=style
  74.               See --footer-numbering.
  75.  
  76.        -f, --footer-numbering=style
  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.               pregexp
  92.                      number only lines that contain a  match  for
  93.                      regexp
  94.  
  95.        -p, --no-renumber
  96.               Do not reset the line number at the start of a log-
  97.               ical page.
  98.  
  99.        -v, --first-page=number
  100.               Set the initial line number on each logical page to
  101.               number (default 1).
  102.  
  103.        -i, --page-increment=number
  104.               Increment line numbers by number (default 1).
  105.  
  106.        -l, --join-blank-lines=number
  107.               Consider number (default 1) consecutive empty lines
  108.               to be one logical line for numbering, and only num-
  109.               ber the last one.  Where fewer than number 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, --number-separator=string
  115.               Separate the line number from the text line in  the
  116.               output with string (default is a TAB character).
  117.  
  118.        -w, --number-width=number
  119.               Use number characters for line numbers (default 6).
  120.  
  121.        -n, --number-format={ln,rn,rz}
  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, --section-delimiter=cc
  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.        --help Print a usage message and exit with a non-zero sta-
  148.               tus.
  149.  
  150.        --version
  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.