man/pr.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH PR "1" "March 2007" "GNU coreutils 6.9" "User Commands"
   3 .SH NAME
   4 pr \- convert text files for printing
   5 .SH SYNOPSIS
   6 .B pr
   7 [\fIOPTION\fR]... [\fIFILE\fR]...
   8 .SH DESCRIPTION
   9 .\" Add any additional description here
  10 .PP
  11 Paginate or columnate FILE(s) for printing.
  12 .PP
  13 Mandatory arguments to long options are mandatory for short options too.
  14 .TP
  15 +FIRST_PAGE[:LAST_PAGE], \fB\-\-pages\fR=\fIFIRST_PAGE[\fR:LAST_PAGE]
  16 begin [stop] printing with page FIRST_[LAST_]PAGE
  17 .TP
  18 \fB\-COLUMN\fR, \fB\-\-columns\fR=\fICOLUMN\fR
  19 output COLUMN columns and print columns down,
  20 unless \fB\-a\fR is used. Balance number of lines in the
  21 columns on each page.
  22 .TP
  23 \fB\-a\fR, \fB\-\-across\fR
  24 print columns across rather than down, used together
  25 with \fB\-COLUMN\fR
  26 .TP
  27 \fB\-c\fR, \fB\-\-show\-control\-chars\fR
  28 use hat notation (^G) and octal backslash notation
  29 .TP
  30 \fB\-d\fR, \fB\-\-double\-space\fR
  31 double space the output
  32 .TP
  33 \fB\-D\fR, \fB\-\-date\-format\fR=\fIFORMAT\fR
  34 use FORMAT for the header date
  35 .TP
  36 \fB\-e[CHAR[WIDTH]]\fR, \fB\-\-expand\-tabs\fR[=\fICHAR[WIDTH]\fR]
  37 expand input CHARs (TABs) to tab WIDTH (8)
  38 .TP
  39 \fB\-F\fR, \fB\-f\fR, \fB\-\-form\-feed\fR
  40 use form feeds instead of newlines to separate pages
  41 (by a 3\-line page header with \fB\-F\fR or a 5\-line header
  42 and trailer without \fB\-F\fR)
  43 .TP
  44 \fB\-h\fR HEADER, \fB\-\-header\fR=\fIHEADER\fR
  45 use a centered HEADER instead of filename in page header,
  46 \fB\-h\fR "" prints a blank line, don't use \fB\-h\fR""
  47 .TP
  48 \fB\-i[CHAR[WIDTH]]\fR, \fB\-\-output\-tabs\fR[=\fICHAR[WIDTH]\fR]
  49 replace spaces with CHARs (TABs) to tab WIDTH (8)
  50 .TP
  51 \fB\-J\fR, \fB\-\-join\-lines\fR
  52 merge full lines, turns off \fB\-W\fR line truncation, no column
  53 alignment, \fB\-\-sep\-string\fR[=\fISTRING\fR] sets separators
  54 .TP
  55 \fB\-l\fR PAGE_LENGTH, \fB\-\-length\fR=\fIPAGE_LENGTH\fR
  56 set the page length to PAGE_LENGTH (66) lines
  57 (default number of lines of text 56, and with \fB\-F\fR 63)
  58 .TP
  59 \fB\-m\fR, \fB\-\-merge\fR
  60 print all files in parallel, one in each column,
  61 truncate lines, but join lines of full length with \fB\-J\fR
  62 .TP
  63 \fB\-n[SEP[DIGITS]]\fR, \fB\-\-number\-lines\fR[=\fISEP[DIGITS]\fR]
  64 number lines, use DIGITS (5) digits, then SEP (TAB),
  65 default counting starts with 1st line of input file
  66 .TP
  67 \fB\-N\fR NUMBER, \fB\-\-first\-line\-number\fR=\fINUMBER\fR
  68 start counting with NUMBER at 1st line of first
  69 page printed (see +FIRST_PAGE)
  70 .TP
  71 \fB\-o\fR MARGIN, \fB\-\-indent\fR=\fIMARGIN\fR
  72 offset each line with MARGIN (zero) spaces, do not
  73 affect \fB\-w\fR or \fB\-W\fR, MARGIN will be added to PAGE_WIDTH
  74 .TP
  75 \fB\-r\fR, \fB\-\-no\-file\-warnings\fR
  76 omit warning when a file cannot be opened
  77 .TP
  78 \fB\-s[CHAR]\fR,\-\-separator[=CHAR]
  79 separate columns by a single character, default for CHAR
  80 is the <TAB> character without \fB\-w\fR and 'no char' with \fB\-w\fR
  81 \fB\-s[CHAR]\fR turns off line truncation of all 3 column
  82 options (\fB\-COLUMN\fR|\-a \fB\-COLUMN\fR|\-m) except \fB\-w\fR is set
  83 .TP
  84 \fB\-SSTRING\fR, \fB\-\-sep\-string\fR[=\fISTRING\fR]
  85 separate columns by STRING,
  86 without \fB\-S\fR: Default separator <TAB> with \fB\-J\fR and <space>
  87 otherwise (same as \fB\-S\fR" "), no effect on column options
  88 .TP
  89 \fB\-t\fR, \fB\-\-omit\-header\fR
  90 omit page headers and trailers
  91 .TP
  92 \fB\-T\fR, \fB\-\-omit\-pagination\fR
  93 omit page headers and trailers, eliminate any pagination
  94 by form feeds set in input files
  95 .TP
  96 \fB\-v\fR, \fB\-\-show\-nonprinting\fR
  97 use octal backslash notation
  98 .TP
  99 \fB\-w\fR PAGE_WIDTH, \fB\-\-width\fR=\fIPAGE_WIDTH\fR
 100 set page width to PAGE_WIDTH (72) characters for
 101 multiple text\-column output only, \fB\-s[char]\fR turns off (72)
 102 .TP
 103 \fB\-W\fR PAGE_WIDTH, \fB\-\-page\-width\fR=\fIPAGE_WIDTH\fR
 104 set page width to PAGE_WIDTH (72) characters always,
 105 truncate lines, except \fB\-J\fR option is set, no interference
 106 with \fB\-S\fR or \fB\-s\fR
 107 .TP
 108 \fB\-\-help\fR
 109 display this help and exit
 110 .TP
 111 \fB\-\-version\fR
 112 output version information and exit
 113 .PP
 114 \fB\-T\fR implied by \fB\-l\fR nn when nn <= 10 or <= 3 with \fB\-F\fR. With no FILE, or when
 115 FILE is \-, read standard input.
 116 .SH AUTHOR
 117 Written by Pete TerMaat and Roland Huebner.
 118 .SH "REPORTING BUGS"
 119 Report bugs to <bug\-coreutils@gnu.org>.
 120 .SH COPYRIGHT
 121 Copyright \(co 2007 Free Software Foundation, Inc.
 122 .br
 123 This is free software.  You may redistribute copies of it under the terms of
 124 the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
 125 There is NO WARRANTY, to the extent permitted by law.
 126 .SH "SEE ALSO"
 127 The full documentation for
 128 .B pr
 129 is maintained as a Texinfo manual.  If the
 130 .B info
 131 and
 132 .B pr
 133 programs are properly installed at your site, the command
 134 .IP
 135 .B info pr
 136 .PP
 137 should give you access to the complete manual.