home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / unix / doc / pr.man < prev    next >
Text File  |  1993-06-13  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. PR(1L)                                                     PR(1L)
  5.  
  6.  
  7. NAME
  8.        pr - convert text files for printing
  9.  
  10. SYNOPSIS
  11.        pr [+PAGE] [-COLUMN] [-abcdfFmrtv] [-e[in-tab-char[in-tab-
  12.        width]]] [-h header] [-i[out-tab-char[out-tab-width]]] [-l
  13.        page-length]   [-n[number-separator[digits]]]   [-o  left-
  14.        margin] [-s[column-separator]]  [-w  page-width]  [--help]
  15.        [--version] [file...]
  16.  
  17. DESCRIPTION
  18.        This  manual  page  documents  the  GNU version of pr.  pr
  19.        prints on the standard output a paginated  and  optionally
  20.        multicolumn  copy  of  the text files given on the command
  21.        line, or of the standard input if no files  are  given  or
  22.        when  the file name `-' is encountered.  Form feeds in the
  23.        input cause page breaks in the output.
  24.  
  25.    OPTIONS
  26.        +PAGE  Begin printing with page PAGE.
  27.  
  28.        -COLUMN
  29.               Produce  COLUMN-column  output  and  print  columns
  30.               down.   The column width is automatically decreased
  31.               as COLUMN increases; unless you use the  -w  option
  32.               to  increase  the  page  width as well, this option
  33.               might cause some columns to be truncated.
  34.  
  35.        -a     Print columns across rather than down.
  36.  
  37.        -b     Balance columns on the last page.
  38.  
  39.        -c     Print control characters using hat notation  (e.g.,
  40.               `^G');  print other unprintable characters in octal
  41.               backslash notation.
  42.  
  43.        -d     Double space the output.
  44.  
  45.        -e[in-tab-char[in-tab-width]]
  46.               Expand tabs to spaces on input.  Optional  argument
  47.               in-tab-char  is  the  input  tab character, default
  48.               tab.  Optional argument in-tab-width is  the  input
  49.               tab character's width, default 8.
  50.  
  51.        -F, -f Use a formfeed instead of newlines to separate out-
  52.               put pages.
  53.  
  54.        -h header
  55.               Replace the filename in the header with the  string
  56.               header.
  57.  
  58.        --help Print a usage message and exit with a non-zero sta-
  59.               tus.
  60.  
  61.  
  62.  
  63.  
  64. FSF                     GNU Text Utilities                      1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PR(1L)                                                     PR(1L)
  71.  
  72.  
  73.        -i[out-tab-char[out-tab-width]]
  74.               Replace spaces with tabs on output.  Optional argu-
  75.               ment  out-tab-char  is  the  output  tab character,
  76.               default tab.  Optional  argument  out-tab-width  is
  77.               the output tab character's width, default 8.
  78.  
  79.        -l page-length
  80.               Set  the  page  length  to  page-length lines.  The
  81.               default is 66.  If page-length is less than 10, the
  82.               headers  and  footers  are  omitted,  as  if the -t
  83.               option had been given.
  84.  
  85.        -m     Print all files in parallel, one in each column.
  86.  
  87.        -n[number-separator[digits]]
  88.               Precede each column with a line number; with paral-
  89.               lel  files,  precede  each line with a line number.
  90.               Optional argument number-separator is the character
  91.               to  print after each number, default tab.  Optional
  92.               argument digits is the number of  digits  per  line
  93.               number, default 5.
  94.  
  95.        -o left-margin
  96.               Offset  each  line with a margin left-margin spaces
  97.               wide.  The total page width is this offset plus the
  98.               width set with the -w option.
  99.  
  100.        -r     Do  not  print  a  warning message when an argument
  101.               file cannot be opened.   Failure  to  open  a  file
  102.               still makes the exit status nonzero, however.
  103.  
  104.        -s[column-separator]
  105.               Separate  columns  by  the single character column-
  106.               separator, default tab, instead of spaces.
  107.  
  108.        -t     Do not print  the  5-line  header  and  the  5-line
  109.               trailer  that are normally on each page, and do not
  110.               fill out the bottoms of pages (with blank lines  or
  111.               formfeeds).
  112.  
  113.        -v     Print  unprintable  characters  in  octal backslash
  114.               notation.
  115.  
  116.        --version
  117.               Print version information on  standard  error  then
  118.               exit.
  119.  
  120.        -w page-width
  121.               Set  the  page  width  to  page-width columns.  The
  122.               default is 72.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. FSF                     GNU Text Utilities                      2
  131.  
  132.  
  133.