man pages section 1: User Commands

Exit Print View

Updated: July 2014

pr (1g)


pr - convert text files for printing


pr [OPTION]... [FILE]...


User Commands                                               PR(1)

     pr - convert text files for printing

     pr [OPTION]... [FILE]...

     Paginate or columnate FILE(s) for printing.

     Mandatory  arguments to long options are mandatory for short
     options too.

          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

     -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 col-
          umn alignment, --sep-string[=STRING] sets separators

GNU coreutils 8.16   Last change: March 2012                    1

User Commands                                               PR(1)

     -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,  trun-
          cate 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, --first-line-number=NUMBER
          start counting with NUMBER at 1st line  of  first  page
          printed (see +FIRST_PAGE)

     -o, --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  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 separa-
          tor  <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  pagina-
          tion 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 multi-
          ple 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 interfer-
          ence with -S or -s

GNU coreutils 8.16   Last change: March 2012                    2

User Commands                                               PR(1)

          display this help and exit

          output version information and exit

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

     Written by Pete TerMaat and Roland Huebner.

     Report pr bugs to
     GNU  coreutils home page: <
     General help using GNU  software:  <
     Report   pr   translation  bugs  to  <http://translationpro->

     Copyright (C) 2012 Free Software Foundation,  Inc.   License
     GPLv3+:      GNU      GPL     version     3     or     later
     This is free software: you are free  to  change  and  redis-
     tribute  it.   There is NO WARRANTY, to the extent permitted
     by law.

     See  attributes(5)  for  descriptions   of   the   following

     |Availability   | file/gnu-coreutils |
     |Stability      | Uncommitted        |
     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.16   Last change: March 2012                    3

User Commands                                               PR(1)

     This   software   was   built   from   source  available  at   The   original
     community       source       was       downloaded       from

     Further information about this software can be found on  the
     open  source  community  website at

GNU coreutils 8.16   Last change: March 2012                    4