home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / bbs / gnu / textutils-1.9-bin.lha / man / cat1 / pr.0 < prev    next >
Encoding:
Text File  |  1993-12-07  |  5.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. PR(1L)                                                     PR(1L)
  5.  
  6.  
  7. NNAAMMEE
  8.        pr - convert text files for printing
  9.  
  10. SSYYNNOOPPSSIISS
  11.        pprr [+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. DDEESSCCRRIIPPTTIIOONN
  18.        This  manual  page  documents  the  GNU version of pprr.  pprr
  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.    OOPPTTIIOONNSS
  26.        _+_P_A_G_E  Begin printing with page _P_A_G_E.
  27.  
  28.        _-_C_O_L_U_M_N
  29.               Produce  _C_O_L_U_M_N-column  output  and  print  columns
  30.               down.   The column width is automatically decreased
  31.               as _C_O_L_U_M_N 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_[_i_n_-_t_a_b_-_c_h_a_r_[_i_n_-_t_a_b_-_w_i_d_t_h_]_]
  46.               Expand tabs to spaces on input.  Optional  argument
  47.               _i_n_-_t_a_b_-_c_h_a_r  is  the  input  tab character, default
  48.               tab.  Optional argument _i_n_-_t_a_b_-_w_i_d_t_h 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 _h_e_a_d_e_r
  55.               Replace the filename in the header with the  string
  56.               _h_e_a_d_e_r.
  57.  
  58.        _-_-_h_e_l_p 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_[_o_u_t_-_t_a_b_-_c_h_a_r_[_o_u_t_-_t_a_b_-_w_i_d_t_h_]_]
  74.               Replace spaces with tabs on output.  Optional argu-
  75.               ment  _o_u_t_-_t_a_b_-_c_h_a_r  is  the  output  tab character,
  76.               default tab.  Optional  argument  _o_u_t_-_t_a_b_-_w_i_d_t_h  is
  77.               the output tab character's width, default 8.
  78.  
  79.        _-_l _p_a_g_e_-_l_e_n_g_t_h
  80.               Set  the  page  length  to  _p_a_g_e_-_l_e_n_g_t_h lines.  The
  81.               default is 66.  If _p_a_g_e_-_l_e_n_g_t_h 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_[_n_u_m_b_e_r_-_s_e_p_a_r_a_t_o_r_[_d_i_g_i_t_s_]_]
  88.               Precede each column with a line number; with paral-
  89.               lel  files,  precede  each line with a line number.
  90.               Optional argument _n_u_m_b_e_r_-_s_e_p_a_r_a_t_o_r is the character
  91.               to  print after each number, default tab.  Optional
  92.               argument _d_i_g_i_t_s is the number of  digits  per  line
  93.               number, default 5.
  94.  
  95.        _-_o _l_e_f_t_-_m_a_r_g_i_n
  96.               Offset  each  line with a margin _l_e_f_t_-_m_a_r_g_i_n 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_[_c_o_l_u_m_n_-_s_e_p_a_r_a_t_o_r_]
  105.               Separate  columns  by  the single character _c_o_l_u_m_n_-
  106.               _s_e_p_a_r_a_t_o_r, 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.        _-_-_v_e_r_s_i_o_n
  117.               Print version information on  standard  error  then
  118.               exit.
  119.  
  120.        _-_w _p_a_g_e_-_w_i_d_t_h
  121.               Set  the  page  width  to  _p_a_g_e_-_w_i_d_t_h columns.  The
  122.               default is 72.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. FSF                     GNU Text Utilities                      2
  131.  
  132.  
  133.