PR(1)				 User Commands				 PR(1)



NAME
       pr - convert text files for printing

SYNOPSIS
       pr [OPTION]... [FILE]...

DESCRIPTION
       Paginate or columnate FILE(s) for printing.

       Mandatory  arguments  to  long  options are mandatory for short options
       too.

       +FIRST_PAGE[:LAST_PAGE], --pages=FIRST_PAGE[:LAST_PAGE]
	      begin [stop] printing with page FIRST_[LAST_]PAGE

       -COLUMN, --columns=COLUMN
	      output COLUMN columns and print columns down, unless -a is used.
	      Balance number of lines in the columns on each page.

       -a, --across
	      print  columns across rather than down, used together with -COL
	      UMN

       -c, --show-control-chars
	      use hat notation (^G) and octal backslash notation

       -d, --double-space
	      double space the output

       -D, --date-format=FORMAT
	      use FORMAT for the header date

       -e[CHAR[WIDTH]], --expand-tabs[=CHAR[WIDTH]]
	      expand input CHARs (TABs) to tab WIDTH (8)

       -F, -f, --form-feed
	      use form feeds instead of  newlines  to  separate  pages	(by  a
	      3-line  page header with -F or a 5-line header and trailer with
	      out -F)

       -h HEADER, --header=HEADER
	      use a centered HEADER instead of filename in page header, -h  ""
	      prints a blank line, dont use -h""

       -i[CHAR[WIDTH]], --output-tabs[=CHAR[WIDTH]]
	      replace spaces with CHARs (TABs) to tab WIDTH (8)

       -J, --join-lines
	      merge full lines, turns off -W line truncation, no column align
	      ment, --sep-string[=STRING] sets separators

       -l PAGE_LENGTH, --length=PAGE_LENGTH
	      set the page length to PAGE_LENGTH (66) lines (default number of
	      lines of text 56, and with -F 63)

       -m, --merge
	      print all files in parallel, one in each column, truncate lines,
	      but join lines of full length with -J

       -n[SEP[DIGITS]], --number-lines[=SEP[DIGITS]]
	      number lines, use DIGITS (5) digits,  then  SEP  (TAB),  default
	      counting starts with 1st line of input file

       -N NUMBER, --first-line-number=NUMBER
	      start  counting  with  NUMBER  at 1st line of first page printed
	      (see +FIRST_PAGE)

       -o MARGIN, --indent=MARGIN
	      offset each line with MARGIN (zero) spaces, do not affect -w  or
	      -W, MARGIN will be added to PAGE_WIDTH

       -r, --no-file-warnings
	      omit warning when a file cannot be opened

       -s[CHAR],--separator[=CHAR]
	      separate	columns by a single character, default for CHAR is the
	       character without -w and no char with -w -s[CHAR]  turns
	      off  line  truncation  of all 3 column options (-COLUMN|-a -COL
	      UMN|-m) except -w is set

       -SSTRING, --sep-string[=STRING]
	      separate columns by STRING, without -S: Default separator  
	      with -J and  otherwise (same as -S" "), no effect on col
	      umn options

       -t, --omit-header omit page headers and trailers

       -T, --omit-pagination
	      omit page headers and trailers, eliminate any pagination by form
	      feeds set in input files

       -v, --show-nonprinting
	      use octal backslash notation

       -w PAGE_WIDTH, --width=PAGE_WIDTH
	      set  page  width	to  PAGE_WIDTH	(72)  characters  for multiple
	      text-column output only, -s[char] turns off (72)

       -W PAGE_WIDTH, --page-width=PAGE_WIDTH
	      set page width to PAGE_WIDTH (72)  characters  always,  truncate
	      lines, except -J option is set, no interference with -S or -s

       --help display this help and exit

       --version
	      output version information and exit

       -T  implied  by	-l  nn when nn <= 10 or <= 3 with -F. With no FILE, or
       when FILE is -, read standard input.

AUTHOR
       Written by Pete TerMaat and Roland Huebner.

REPORTING BUGS
       Report bugs to .

COPYRIGHT
       Copyright  2006 Free Software Foundation, Inc.
       This is free software.  You may redistribute copies  of	it  under  the
       terms	   of	    the      GNU      General	   Public      License
       .	There is NO WARRANTY,  to  the
       extent permitted by law.

SEE ALSO
       The  full  documentation  for pr is maintained as a Texinfo manual.  If
       the info and pr programs are properly installed at your site, the  com
       mand

	      info pr

       should give you access to the complete manual.



pr 5.97 			 January 2007				 PR(1)