home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / GNUTUE.ZIP / man / pr.man < prev    next >
Text File  |  1992-07-18  |  4KB  |  86 lines
  1. NAME
  2.      pr - convert text files for printing
  3.  
  4. SYNOPSIS
  5.      pr [+PAGE] [-COLUMN]  [-abcdfFmrtv]  [-e[in-tab-char[in-tab-width]]]  [-h
  6.      header]  [-i[out-tab-char[out-tab-width]]]  [-l  page-length] [-n[number-
  7.      separator[digits]]] [-o  left-margin]  [-s[column-separator]]  [-w  page-
  8.      width] [file...]
  9.  
  10. DESCRIPTION
  11.      This manual page documents the GNU version  of  pr.   pr  prints  on  the
  12.      standard  output  a paginated and optionally multicolumn copy of the text
  13.      files given on the command line, or of the standard input if no files are
  14.      given  or when the file name `-' is encountered.  Form feeds in the input
  15.      cause page breaks in the output.
  16.  
  17.      OPTIONS
  18.  
  19.      +PAGE
  20.           Begin printing with page PAGE.
  21.  
  22.      -COLUMN
  23.           Produce COLUMN-column output and print  columns  down.   The  column
  24.           width is automatically decreased as COLUMN increases; unless you use
  25.           the -w option to increase the page width as well, this option  might
  26.           cause some columns to be truncated.
  27.  
  28.      -a   Print columns across rather than down.
  29.  
  30.      -b   Balance columns on the last page.
  31.  
  32.      -c   Print control characters using  hat  notation  (e.g.,  `^G');  print
  33.           other unprintable characters in octal backslash notation.
  34.  
  35.      -d   Double space the output.
  36.  
  37.      -e[in-tab-char[in-tab-width]]
  38.           Expand tabs to spaces on input.  Optional  argument  in-tab-char  is
  39.           the  input  tab  character,  default tab.  Optional argument in-tab-
  40.           width is the input tab character's width, default 8.
  41.  
  42.      -F, -f
  43.           Use a formfeed instead of newlines to separate output pages.
  44.  
  45.      -h header
  46.           Replace the filename in the header with the string header.
  47.  
  48.      -i[out-tab-char[out-tab-width]]
  49.           Replace spaces with tabs on output.  Optional argument  out-tab-char
  50.           is  the  output  tab character, default tab.  Optional argument out-
  51.           tab-width is the output tab character's width, default 8.
  52.  
  53.      -l page-length
  54.           Set the page length to page-length lines.  The default  is  66.   If
  55.           page-length is less than 10, the headers and footers are omitted, as
  56.           if the -t option had been given.
  57.  
  58.      -m   Print all files in parallel, one in each column.
  59.  
  60.      -n[number-separator[digits]]
  61.           Precede each column with a line number; with parallel files, precede
  62.           each line with a line number.  Optional argument number-separator is
  63.           the character to print after each  number,  default  tab.   Optional
  64.           argument digits is the number of digits per line number, default 5.
  65.  
  66.      -o left-margin
  67.           Offset each line with a margin left-margin spaces wide.   The  total
  68.           page width is this offset plus the width set with the -w option.
  69.  
  70.      -r   Do not print a warning message  when  an  argument  file  cannot  be
  71.           opened.  Failure to open a file still makes the exit status nonzero,
  72.           however.
  73.  
  74.      -s[column-separator]
  75.           Separate columns by the single character  column-separator,  default
  76.           tab, instead of spaces.
  77.  
  78.      -t   Do not print the 5-line header  and  the  5-line  trailer  that  are
  79.           normally  on  each  page,  and  do not fill out the bottoms of pages
  80.           (with blank lines or formfeeds).
  81.  
  82.      -v   Print unprintable characters in octal backslash notation.
  83.  
  84.      -w page-width
  85.           Set the page width to page-width columns.  The default is 72.
  86.