


PR(1L)                                                     PR(1L)


NNAAMMEE
       pr - convert text files for printing

SSYYNNOOPPSSIISS
       pprr [+PAGE] [-COLUMN] [-abcdfFmrtv] [-e[in-tab-char[in-tab-
       width]]] [-h header] [-i[out-tab-char[out-tab-width]]] [-l
       page-length]   [-n[number-separator[digits]]]   [-o  left-
       margin] [-s[column-separator]]  [-w  page-width]  [--help]
       [--version] [file...]

DDEESSCCRRIIPPTTIIOONN
       This  manual  page  documents  the  GNU version of pprr.  pprr
       prints on the standard output a paginated  and  optionally
       multicolumn  copy  of  the text files given on the command
       line, or of the standard input if no files  are  given  or
       when  the file name `-' is encountered.  Form feeds in the
       input cause page breaks in the output.

   OOPPTTIIOONNSS
       _+_P_A_G_E  Begin printing with page _P_A_G_E.

       _-_C_O_L_U_M_N
              Produce  _C_O_L_U_M_N-column  output  and  print  columns
              down.   The column width is automatically decreased
              as _C_O_L_U_M_N increases; unless you use the  _-_w  option
              to  increase  the  page  width as well, this option
              might cause some columns to be truncated.

       _-_a     Print columns across rather than down.

       _-_b     Balance columns on the last page.

       _-_c     Print control characters using hat notation  (e.g.,
              `^G');  print other unprintable characters in octal
              backslash notation.

       _-_d     Double space the output.

       _-_e_[_i_n_-_t_a_b_-_c_h_a_r_[_i_n_-_t_a_b_-_w_i_d_t_h_]_]
              Expand tabs to spaces on input.  Optional  argument
              _i_n_-_t_a_b_-_c_h_a_r  is  the  input  tab character, default
              tab.  Optional argument _i_n_-_t_a_b_-_w_i_d_t_h is  the  input
              tab character's width, default 8.

       _-_F_, _-_f Use a formfeed instead of newlines to separate out-
              put pages.

       _-_h _h_e_a_d_e_r
              Replace the filename in the header with the  string
              _h_e_a_d_e_r.

       _-_-_h_e_l_p Print a usage message and exit with a non-zero sta-
              tus.




FSF                     GNU Text Utilities                      1





PR(1L)                                                     PR(1L)


       _-_i_[_o_u_t_-_t_a_b_-_c_h_a_r_[_o_u_t_-_t_a_b_-_w_i_d_t_h_]_]
              Replace spaces with tabs on output.  Optional argu-
              ment  _o_u_t_-_t_a_b_-_c_h_a_r  is  the  output  tab character,
              default tab.  Optional  argument  _o_u_t_-_t_a_b_-_w_i_d_t_h  is
              the output tab character's width, default 8.

       _-_l _p_a_g_e_-_l_e_n_g_t_h
              Set  the  page  length  to  _p_a_g_e_-_l_e_n_g_t_h lines.  The
              default is 66.  If _p_a_g_e_-_l_e_n_g_t_h is less than 10, the
              headers  and  footers  are  omitted,  as  if the _-_t
              option had been given.

       _-_m     Print all files in parallel, one in each column.

       _-_n_[_n_u_m_b_e_r_-_s_e_p_a_r_a_t_o_r_[_d_i_g_i_t_s_]_]
              Precede each column with a line number; with paral-
              lel  files,  precede  each line with a line number.
              Optional argument _n_u_m_b_e_r_-_s_e_p_a_r_a_t_o_r is the character
              to  print after each number, default tab.  Optional
              argument _d_i_g_i_t_s is the number of  digits  per  line
              number, default 5.

       _-_o _l_e_f_t_-_m_a_r_g_i_n
              Offset  each  line with a margin _l_e_f_t_-_m_a_r_g_i_n spaces
              wide.  The total page width is this offset plus the
              width set with the _-_w option.

       _-_r     Do  not  print  a  warning message when an argument
              file cannot be opened.   Failure  to  open  a  file
              still makes the exit status nonzero, however.

       _-_s_[_c_o_l_u_m_n_-_s_e_p_a_r_a_t_o_r_]
              Separate  columns  by  the single character _c_o_l_u_m_n_-
              _s_e_p_a_r_a_t_o_r, default tab, instead of spaces.

       _-_t     Do not print  the  5-line  header  and  the  5-line
              trailer  that are normally on each page, and do not
              fill out the bottoms of pages (with blank lines  or
              formfeeds).

       _-_v     Print  unprintable  characters  in  octal backslash
              notation.

       _-_-_v_e_r_s_i_o_n
              Print version information on standard  output  then
              exit.

       _-_w _p_a_g_e_-_w_i_d_t_h
              Set  the  page  width  to  _p_a_g_e_-_w_i_d_t_h columns.  The
              default is 72.







FSF                     GNU Text Utilities                      2


