PR
Section: User Commands (1)
Updated: GNU Text Utilities
Index
Return to Main Contents
NAME
pr - convert text files for printing
SYNOPSIS
pr
[+PAGE] [-COLUMN] [-abcdfFmrtv] [-e[in-tab-char[in-tab-width]]]
[-h header] [-i[out-tab-char[out-tab-width]]] [-l page-length]
[-n[number-separator[digits]]] [-o left-margin]
[-s[column-separator]] [-w page-width] [--help] [--version] [file...]
DESCRIPTION
This documentation is no longer being maintained and may be inaccurate
or incomplete. The Texinfo documentation is now the authoritative source.
This manual page
documents the GNU version of
pr.
pr
prints on the standard output a paginated and optionally multicolumn
copy of the text files given on the command line, or of the standard
input if no files are given or when the file name `-' is encountered.
Form feeds in the input cause page breaks in the output.
OPTIONS
- +PAGE
-
Begin printing with page PAGE.
- -COLUMN
-
Produce COLUMN-column output and print columns down. The column
width is automatically decreased as COLUMN increases; unless you
use the -w option to increase the page width as well, this
option might cause some columns to be truncated.
- -a
-
Print columns across rather than down.
- -b
-
Balance columns on the last page.
- -c
-
Print control characters using hat notation (e.g., `^G'); print other
unprintable characters in octal backslash notation.
- -d
-
Double space the output.
- -e[in-tab-char[in-tab-width]]
-
Expand tabs to spaces on input. Optional argument in-tab-char
is the input tab character, default tab. Optional argument
in-tab-width is the input tab character's width, default 8.
- -F, -f
-
Use a formfeed instead of newlines to separate output pages.
- -h header
-
Replace the filename in the header with the string header.
- --help
-
Print a usage message and exit with a status code indicating success.
- -i[out-tab-char[out-tab-width]]
-
Replace spaces with tabs on output. Optional argument
out-tab-char is the output tab character, default tab.
Optional argument out-tab-width is the output tab character's
width, default 8.
- -l page-length
-
Set the page length to page-length lines. The default is 66.
If page-length is less than 10, the headers and footers are
omitted, as if the -t option had been given.
- -m
-
Print all files in parallel, one in each column.
- -n[number-separator[digits]]
-
Precede each column with a line number; with parallel files, precede
each line with a line number. Optional argument
number-separator is the character to print after each number,
default tab. Optional argument digits is the number of digits
per line number, default 5.
- -o left-margin
-
Offset each line with a margin left-margin spaces wide. The
total page width is this offset plus the width set with the -w
option.
- -r
-
Do not print a warning message when an argument file cannot be opened.
Failure to open a file still makes the exit status nonzero, however.
- -s[column-separator]
-
Separate columns by the single character column-separator,
default tab, instead of spaces.
- -t
-
Do not print the 5-line header and the 5-line trailer that are
normally on each page, and do not fill out the bottoms of pages (with
blank lines or formfeeds).
- -v
-
Print unprintable characters in octal backslash notation.
- --version
-
Print version information on standard output then exit.
- -w page-width
-
Set the page width to page-width columns. The default is 72.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
This document was created by
man2html,
using the manual pages.
Time: 15:54:34 GMT, January 15, 2023