man/cat1/pr.1.txt

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 -COLUMN
 
       -c, --show-control-chars
              use hat notation (^G) and octal backslash nota-
              tion
 
       -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 without -F)
 
       -h HEADER, --header=HEADER
              use a centered HEADER instead of filename in page
              header, -h "" prints a blank line, don't 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 alignment, --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 <TAB> character without -w and
              'no char' with -w -s[CHAR] turns off line trunca-
              tion 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 <TAB> with -J and <space> otherwise
              (same as -S" "), no effect on column 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 <bug-coreutils@gnu.org>.
 
COPYRIGHT
       Copyright (C) 2005 Free Software Foundation, Inc.
       This is free software; see the source for copying condi-
       tions. There is NO warranty; not even for MERCHANTABIL-
       ITY or FITNESS FOR A PARTICULAR PURPOSE.
 
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 command
 
              info pr
 
       should give you access to the complete manual.
 
 
 
pr 5.3.0 January 2005 PR(1)