pr(1) — Linux manual page


PR(1)                         User Commands                        PR(1)

NAME         top

       pr - convert text files for printing

SYNOPSIS         top

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

DESCRIPTION         top

       Paginate or columnate FILE(s) for printing.

       With no FILE, or when FILE is -, read standard input.

       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 page

       -a, --across
              print columns across rather than down, used together with

       -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 separators

       -l, --length=PAGE_LENGTH
              set the page length to PAGE_LENGTH (66) lines (default
              number of lines of text 56, and with -F 63).  implies -t
              if PAGE_LENGTH <= 10

       -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, --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 separator
              <TAB> with -J and <space> otherwise (same as -S" "), no
              effect on column options

       -t, --omit-header
              omit page headers and trailers; implied if PAGE_LENGTH <=

       -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 interference
              with -S or -s

       --help display this help and exit

              output version information and exit

AUTHOR         top

       Written by Pete TerMaat and Roland Huebner.

REPORTING BUGS         top

       GNU coreutils online help:
       Report any translation bugs to

COPYRIGHT         top

       Copyright © 2024 Free Software Foundation, Inc.  License GPLv3+:
       GNU GPL version 3 or later <>.
       This is free software: you are free to change and redistribute
       it.  There is NO WARRANTY, to the extent permitted by law.

SEE ALSO         top

       Full documentation <>
       or available locally via: info '(coreutils) pr invocation'

COLOPHON         top

       This page is part of the coreutils (basic file, shell and text
       manipulation utilities) project.  Information about the project
       can be found at ⟨⟩.  If you
       have a bug report for this manual page, see
       ⟨⟩.  This page was obtained
       from the tarball coreutils-9.5.tar.xz fetched from
       ⟨⟩ on 2024-06-14.  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for
       the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original
       manual page), send a mail to

GNU coreutils 9.5              March 2024                          PR(1)