home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / gnustuff / tos / futils / futils~1 / man / manpages.zoo / pr.1 < prev    next >
Encoding:
Text File  |  1991-11-11  |  4.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. PR(1L)                                                     PR(1L)
  5.  
  6.  
  7.  
  8. NAME
  9.      pr - convert text files for printing
  10.  
  11. SYNOPSIS
  12.      pr [+PAGE] [-COLUMN] [-abcdfFmrtv] [-e[in-tab-char[in-tab-
  13.      width]]] [-h header] [-i[out-tab-char[out-tab-width]]] [-l
  14.      page-length] [-n[number-separator[digits]]] [-o left-margin]
  15.      [-s[column-separator]] [-w page-width] [file...]
  16.  
  17. DESCRIPTION
  18.      This manual page documents the GNU version of pr.  pr prints
  19.      on the standard output a paginated and optionally mul-
  20.      ticolumn copy of the text files given on the command line,
  21.      or of the standard input if no files are given or when the
  22.      file name `-' is encountered.  Form feeds in the input cause
  23.      page breaks in the output.
  24.  
  25.      OPTIONS
  26.  
  27.      +_✓P_✓A_✓G_✓E
  28.           Begin printing with page _✓P_✓A_✓G_✓E.
  29.  
  30.      -_✓C_✓O_✓L_✓U_✓M_✓N
  31.           Produce _✓C_✓O_✓L_✓U_✓M_✓N-column output and print columns down.
  32.           The column width is automatically decreased as _✓C_✓O_✓L_✓U_✓M_✓N
  33.           increases; unless you use the -_✓w option to increase the
  34.           page width as well, this option might cause some
  35.           columns to be truncated.
  36.  
  37.      -_✓a   Print columns across rather than down.
  38.  
  39.      -_✓b   Balance columns on the last page.
  40.  
  41.      -_✓c   Print control characters using hat notation (e.g.,
  42.           `^G'); print other unprintable characters in octal
  43.           backslash notation.
  44.  
  45.      -_✓d   Double space the output.
  46.  
  47.      -_✓e[_✓i_✓n-_✓t_✓a_✓b-_✓c_✓h_✓a_✓r[_✓i_✓n-_✓t_✓a_✓b-_✓w_✓i_✓d_✓t_✓h]]
  48.           Expand tabs to spaces on input.  Optional argument _✓i_✓n-
  49.           _✓t_✓a_✓b-_✓c_✓h_✓a_✓r is the input tab character, default tab.
  50.           Optional argument _✓i_✓n-_✓t_✓a_✓b-_✓w_✓i_✓d_✓t_✓h is the input tab
  51.           character's width, default 8.
  52.  
  53.      -_✓F, -_✓f
  54.           Use a formfeed instead of newlines to separate output
  55.           pages.
  56.  
  57.      -_✓h _✓h_✓e_✓a_✓d_✓e_✓r
  58.           Replace the filename in the header with the string
  59.           _✓h_✓e_✓a_✓d_✓e_✓r.
  60.  
  61.  
  62.  
  63. Page 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PR(1L)                                                     PR(1L)
  71.  
  72.  
  73.  
  74.      -_✓i[_✓o_✓u_✓t-_✓t_✓a_✓b-_✓c_✓h_✓a_✓r[_✓o_✓u_✓t-_✓t_✓a_✓b-_✓w_✓i_✓d_✓t_✓h]]
  75.           Replace spaces with tabs on output.  Optional argument
  76.           _✓o_✓u_✓t-_✓t_✓a_✓b-_✓c_✓h_✓a_✓r is the output tab character, default tab.
  77.           Optional argument _✓o_✓u_✓t-_✓t_✓a_✓b-_✓w_✓i_✓d_✓t_✓h is the output tab
  78.           character's width, default 8.
  79.  
  80.      -_✓l _✓p_✓a_✓g_✓e-_✓l_✓e_✓n_✓g_✓t_✓h
  81.           Set the page length to _✓p_✓a_✓g_✓e-_✓l_✓e_✓n_✓g_✓t_✓h lines.  The default
  82.           is 66.  If _✓p_✓a_✓g_✓e-_✓l_✓e_✓n_✓g_✓t_✓h is less than 10, the headers and
  83.           footers are omitted, as if the -_✓t option had been
  84.           given.
  85.  
  86.      -_✓m   Print all files in parallel, one in each column.
  87.  
  88.      -_✓n[_✓n_✓u_✓m_✓b_✓e_✓r-_✓s_✓e_✓p_✓a_✓r_✓a_✓t_✓o_✓r[_✓d_✓i_✓g_✓i_✓t_✓s]]
  89.           Precede each column with a line number; with parallel
  90.           files, precede each line with a line number.  Optional
  91.           argument _✓n_✓u_✓m_✓b_✓e_✓r-_✓s_✓e_✓p_✓a_✓r_✓a_✓t_✓o_✓r is the character to print
  92.           after each number, default tab.  Optional argument
  93.           _✓d_✓i_✓g_✓i_✓t_✓s is the number of digits per line number, default
  94.           5.
  95.  
  96.      -_✓o _✓l_✓e_✓f_✓t-_✓m_✓a_✓r_✓g_✓i_✓n
  97.           Offset each line with a margin _✓l_✓e_✓f_✓t-_✓m_✓a_✓r_✓g_✓i_✓n spaces wide.
  98.           The total page width is this offset plus the width set
  99.           with the -_✓w option.
  100.  
  101.      -_✓r   Do not print a warning message when an argument file
  102.           cannot be opened.  Failure to open a file still makes
  103.           the exit status nonzero, however.
  104.  
  105.      -_✓s[_✓c_✓o_✓l_✓u_✓m_✓n-_✓s_✓e_✓p_✓a_✓r_✓a_✓t_✓o_✓r]
  106.           Separate columns by the single character _✓c_✓o_✓l_✓u_✓m_✓n-
  107.           _✓s_✓e_✓p_✓a_✓r_✓a_✓t_✓o_✓r, default tab, instead of spaces.
  108.  
  109.      -_✓t   Prevent the printing of the 5-line header and the 5-
  110.           line trailer that are normally on each page.
  111.  
  112.      -_✓v   Print unprintable characters in octal backslash nota-
  113.           tion.
  114.  
  115.      -_✓w _✓p_✓a_✓g_✓e-_✓w_✓i_✓d_✓t_✓h
  116.           Set the page width to _✓p_✓a_✓g_✓e-_✓w_✓i_✓d_✓t_✓h columns.  The default
  117.           is 72.
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Page 2
  130.  
  131.  
  132.  
  133.