man-pages/man1/pr.1.html
2021-03-31 01:06:50 +01:00

156 lines
6.1 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of PR</TITLE>
</HEAD><BODY>
<H1>PR</H1>
Section: User Commands (1)<BR>Updated: September 2019<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
pr - convert text files for printing
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>pr</B>
[<I>,OPTION/</I>]... [<I>,FILE/</I>]...
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<P>
Paginate or columnate FILE(s) for printing.
<P>
With no FILE, or when FILE is -, read standard input.
<P>
Mandatory arguments to long options are mandatory for short options too.
<DL COMPACT>
<DT id="1">+FIRST_PAGE[:LAST_PAGE], <B>--pages</B>=<I>,FIRST_PAGE[/</I>:LAST_PAGE]<DD>
begin [stop] printing with page FIRST_[LAST_]PAGE
<DT id="2"><B>-COLUMN</B>, <B>--columns</B>=<I>,COLUMN/</I><DD>
output COLUMN columns and print columns down,
unless <B>-a</B> is used. Balance number of lines in the
columns on each page
<DT id="3"><B>-a</B>, <B>--across</B><DD>
print columns across rather than down, used together
with <B>-COLUMN</B>
<DT id="4"><B>-c</B>, <B>--show-control-chars</B><DD>
use hat notation (^G) and octal backslash notation
<DT id="5"><B>-d</B>, <B>--double-space</B><DD>
double space the output
<DT id="6"><B>-D</B>, <B>--date-format</B>=<I>,FORMAT/</I><DD>
use FORMAT for the header date
<DT id="7"><B>-e[CHAR[WIDTH]]</B>, <B>--expand-tabs</B>[=<I>,CHAR[WIDTH]/</I>]<DD>
expand input CHARs (TABs) to tab WIDTH (8)
<DT id="8"><B>-F</B>, <B>-f</B>, <B>--form-feed</B><DD>
use form feeds instead of newlines to separate pages
(by a 3-line page header with <B>-F</B> or a 5-line header
and trailer without <B>-F</B>)
<DT id="9"><B>-h</B>, <B>--header</B>=<I>,HEADER/</I><DD>
use a centered HEADER instead of filename in page header,
<B>-h</B> &quot;&quot; prints a blank line, don't use <B>-h</B>&quot;&quot;
<DT id="10"><B>-i[CHAR[WIDTH]]</B>, <B>--output-tabs</B>[=<I>,CHAR[WIDTH]/</I>]<DD>
replace spaces with CHARs (TABs) to tab WIDTH (8)
<DT id="11"><B>-J</B>, <B>--join-lines</B><DD>
merge full lines, turns off <B>-W</B> line truncation, no column
alignment, <B>--sep-string</B>[=<I>,STRING/</I>] sets separators
<DT id="12"><B>-l</B>, <B>--length</B>=<I>,PAGE_LENGTH/</I><DD>
set the page length to PAGE_LENGTH (66) lines
(default number of lines of text 56, and with <B>-F</B> 63).
implies <B>-t</B> if PAGE_LENGTH &lt;= 10
<DT id="13"><B>-m</B>, <B>--merge</B><DD>
print all files in parallel, one in each column,
truncate lines, but join lines of full length with <B>-J</B>
<DT id="14"><B>-n[SEP[DIGITS]]</B>, <B>--number-lines</B>[=<I>,SEP[DIGITS]/</I>]<DD>
number lines, use DIGITS (5) digits, then SEP (TAB),
default counting starts with 1st line of input file
<DT id="15"><B>-N</B>, <B>--first-line-number</B>=<I>,NUMBER/</I><DD>
start counting with NUMBER at 1st line of first
page printed (see +FIRST_PAGE)
<DT id="16"><B>-o</B>, <B>--indent</B>=<I>,MARGIN/</I><DD>
offset each line with MARGIN (zero) spaces, do not
affect <B>-w</B> or <B>-W</B>, MARGIN will be added to PAGE_WIDTH
<DT id="17"><B>-r</B>, <B>--no-file-warnings</B><DD>
omit warning when a file cannot be opened
<DT id="18"><B>-s[CHAR]</B>, <B>--separator</B>[=<I>,CHAR/</I>]<DD>
separate columns by a single character, default for CHAR
is the &lt;TAB&gt; character without <B>-w</B> and 'no char' with <B>-w</B>.
<B>-s[CHAR]</B> turns off line truncation of all 3 column
options (<B>-COLUMN</B>|-a <B>-COLUMN</B>|-m) except <B>-w</B> is set
<DT id="19"><B>-S[STRING]</B>, <B>--sep-string</B>[=<I>,STRING/</I>]<DD>
separate columns by STRING,
without <B>-S</B>: Default separator &lt;TAB&gt; with <B>-J</B> and &lt;space&gt;
otherwise (same as <B>-S</B>&quot; &quot;), no effect on column options
<DT id="20"><B>-t</B>, <B>--omit-header</B><DD>
omit page headers and trailers;
implied if PAGE_LENGTH &lt;= 10
<DT id="21"><B>-T</B>, <B>--omit-pagination</B><DD>
omit page headers and trailers, eliminate any pagination
by form feeds set in input files
<DT id="22"><B>-v</B>, <B>--show-nonprinting</B><DD>
use octal backslash notation
<DT id="23"><B>-w</B>, <B>--width</B>=<I>,PAGE_WIDTH/</I><DD>
set page width to PAGE_WIDTH (72) characters for
multiple text-column output only, <B>-s[char]</B> turns off (72)
<DT id="24"><B>-W</B>, <B>--page-width</B>=<I>,PAGE_WIDTH/</I><DD>
set page width to PAGE_WIDTH (72) characters always,
truncate lines, except <B>-J</B> option is set, no interference
with <B>-S</B> or <B>-s</B>
<DT id="25"><B>--help</B><DD>
display this help and exit
<DT id="26"><B>--version</B><DD>
output version information and exit
</DL>
<A NAME="lbAE">&nbsp;</A>
<H2>AUTHOR</H2>
Written by Pete TerMaat and Roland Huebner.
<A NAME="lbAF">&nbsp;</A>
<H2>REPORTING BUGS</H2>
GNU coreutils online help: &lt;<A HREF="https://www.gnu.org/software/coreutils/">https://www.gnu.org/software/coreutils/</A>&gt;
<BR>
Report pr translation bugs to &lt;<A HREF="https://translationproject.org/team/">https://translationproject.org/team/</A>&gt;
<A NAME="lbAG">&nbsp;</A>
<H2>COPYRIGHT</H2>
Copyright &#169; 2018 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later &lt;<A HREF="https://gnu.org/licenses/gpl.html">https://gnu.org/licenses/gpl.html</A>&gt;.
<BR>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
<A NAME="lbAH">&nbsp;</A>
<H2>SEE ALSO</H2>
Full documentation at: &lt;<A HREF="https://www.gnu.org/software/coreutils/pr">https://www.gnu.org/software/coreutils/pr</A>&gt;
<BR>
or available locally via: info '(coreutils) pr invocation'
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="27"><A HREF="#lbAB">NAME</A><DD>
<DT id="28"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="29"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="30"><A HREF="#lbAE">AUTHOR</A><DD>
<DT id="31"><A HREF="#lbAF">REPORTING BUGS</A><DD>
<DT id="32"><A HREF="#lbAG">COPYRIGHT</A><DD>
<DT id="33"><A HREF="#lbAH">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:25 GMT, March 31, 2021
</BODY>
</HTML>