original/man1/pr.1

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