


PR(1L)							PR(1L)


NNAAMMEE
       pr - convert text files for printing

SSYYNNOOPPSSIISS
       pprr [+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...]

DDEESSCCRRIIPPTTIIOONN
       This  manual  page  documents  the  GNU version of pprr.  pprr
       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.

   OOPPTTIIOONNSS
       _+_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  error  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


