original/man1/pr.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH PR "1" "April 2010" "GNU coreutils 8.5" "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, \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, \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, \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, \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, \fB\-\-separator\fR[=\fICHAR\fR]
  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, \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, \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 is implied if PAGE_LENGTH <= 10.  With no FILE, or when FILE is \-, read
 115 standard input.
 116 .SH AUTHOR
 117 Written by Pete TerMaat and Roland Huebner.
 118 .SH "REPORTING BUGS"
 119 Report pr bugs to bug\-coreutils@gnu.org
 120 .br
 121 GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
 122 .br
 123 General help using GNU software: <http://www.gnu.org/gethelp/>
 124 .br
 125 Report pr translation bugs to <http://translationproject.org/team/>
 126 .SH COPYRIGHT
 127 Copyright \(co 2010 Free Software Foundation, Inc.
 128 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
 129 .br
 130 This is free software: you are free to change and redistribute it.
 131 There is NO WARRANTY, to the extent permitted by law.
 132 .SH "SEE ALSO"
 133 The full documentation for
 134 .B pr
 135 is maintained as a Texinfo manual.  If the
 136 .B info
 137 and
 138 .B pr
 139 programs are properly installed at your site, the command
 140 .IP
 141 .B info coreutils \(aqpr invocation\(aq
 142 .PP
 143 should give you access to the complete manual.