Back to main site | Back to man page index

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 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 without -F)

       -h, --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 separa‐
              tors

       -l, --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
              char' with -w -s[CHAR] turns off line truncation of all 3 column options (-COLUMN|-a -COLUMN|-m) except
              -w is set

       -S[STRING], --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, --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
              set page width to PAGE_WIDTH (72) characters always, truncate lines, except -J option is set, no inter‐
              ference with -S or -s

       --help display this help and exit

       --version
              output version information and exit

       -t is implied if PAGE_LENGTH <= 10.  With no FILE, or when FILE is -, read standard input.

       GNU  coreutils  online  help:  <http://www.gnu.org/software/coreutils/>  Report   pr   translation   bugs   to
       <http://translationproject.org/team/>

AUTHOR
       Written by Pete TerMaat and Roland Huebner.

COPYRIGHT
       Copyright   ©   2013   Free   Software   Foundation,  Inc.   License  GPLv3+:  GNU  GPL  version  3  or  later
       <http://gnu.org/licenses/gpl.html>.
       This is free software: you are free to change and redistribute it.  There is NO WARRANTY, to the  extent  per‐
       mitted 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 command

              info coreutils 'pr invocation'

       should give you access to the complete manual.



GNU coreutils 8.22                                  November 2016                                               PR(1)