xref: /freebsd/usr.bin/pr/pr.1 (revision 4bf9895e5558a42211044a8970e4e405ebee08cd)
19b50d902SRodney W. Grimes.\" Copyright (c) 1991 Keith Muller.
29b50d902SRodney W. Grimes.\" Copyright (c) 1993
39b50d902SRodney W. Grimes.\"	The Regents of the University of California.  All rights reserved.
49b50d902SRodney W. Grimes.\"
59b50d902SRodney W. Grimes.\" This code is derived from software contributed to Berkeley by
69b50d902SRodney W. Grimes.\" Keith Muller of the University of California, San Diego.
79b50d902SRodney W. Grimes.\"
89b50d902SRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without
99b50d902SRodney W. Grimes.\" modification, are permitted provided that the following conditions
109b50d902SRodney W. Grimes.\" are met:
119b50d902SRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright
129b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer.
139b50d902SRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright
149b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer in the
159b50d902SRodney W. Grimes.\"    documentation and/or other materials provided with the distribution.
169b50d902SRodney W. Grimes.\" 3. All advertising materials mentioning features or use of this software
179b50d902SRodney W. Grimes.\"    must display the following acknowledgement:
189b50d902SRodney W. Grimes.\"	This product includes software developed by the University of
199b50d902SRodney W. Grimes.\"	California, Berkeley and its contributors.
209b50d902SRodney W. Grimes.\" 4. Neither the name of the University nor the names of its contributors
219b50d902SRodney W. Grimes.\"    may be used to endorse or promote products derived from this software
229b50d902SRodney W. Grimes.\"    without specific prior written permission.
239b50d902SRodney W. Grimes.\"
249b50d902SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
259b50d902SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
269b50d902SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
279b50d902SRodney W. Grimes.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
289b50d902SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
299b50d902SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
309b50d902SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
319b50d902SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
329b50d902SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
339b50d902SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
349b50d902SRodney W. Grimes.\" SUCH DAMAGE.
359b50d902SRodney W. Grimes.\"
369b50d902SRodney W. Grimes.\"     @(#)pr.1	8.3 (Berkeley) 4/18/94
37c3aac50fSPeter Wemm.\" $FreeBSD$
389b50d902SRodney W. Grimes.\"
399b50d902SRodney W. Grimes.Dd April 18, 1994
409b50d902SRodney W. Grimes.Dt PR 1
419b50d902SRodney W. Grimes.Os BSD 4.4
429b50d902SRodney W. Grimes.Sh NAME
439b50d902SRodney W. Grimes.Nm pr
449b50d902SRodney W. Grimes.Nd print files
459b50d902SRodney W. Grimes.Sh SYNOPSIS
46b637dfa8SPhilippe Charnier.Nm
479b50d902SRodney W. Grimes.Bk -words
489b50d902SRodney W. Grimes.Op Ar \&+page
499b50d902SRodney W. Grimes.Ek
509b50d902SRodney W. Grimes.Bk -words
519b50d902SRodney W. Grimes.Op Fl Ar column
529b50d902SRodney W. Grimes.Ek
534bf9895eSAndrey A. Chernov.Op Fl adFmrt
549b50d902SRodney W. Grimes.Bk -words
559b50d902SRodney W. Grimes.Oo
569b50d902SRodney W. Grimes.Op Fl e
579b50d902SRodney W. Grimes.Op Ar char
589b50d902SRodney W. Grimes.Op Ar gap
599b50d902SRodney W. Grimes.Oc
609b50d902SRodney W. Grimes.Ek
619b50d902SRodney W. Grimes.Bk -words
624bf9895eSAndrey A. Chernov.Op Fl L Ar locale
634bf9895eSAndrey A. Chernov.Ek
644bf9895eSAndrey A. Chernov.Bk -words
659b50d902SRodney W. Grimes.Op Fl h Ar header
669b50d902SRodney W. Grimes.Ek
679b50d902SRodney W. Grimes.Bk -words
689b50d902SRodney W. Grimes.Oo
699b50d902SRodney W. Grimes.Op Fl i
709b50d902SRodney W. Grimes.Op Ar char
719b50d902SRodney W. Grimes.Op Ar gap
729b50d902SRodney W. Grimes.Oc
739b50d902SRodney W. Grimes.Ek
749b50d902SRodney W. Grimes.Bk -words
759b50d902SRodney W. Grimes.Op Fl l Ar lines
769b50d902SRodney W. Grimes.Ek
779b50d902SRodney W. Grimes.Bk -words
789b50d902SRodney W. Grimes.Op Fl o Ar offset
799b50d902SRodney W. Grimes.Ek
809b50d902SRodney W. Grimes.Bk -words
819b50d902SRodney W. Grimes.Oo
829b50d902SRodney W. Grimes.Op Fl s
839b50d902SRodney W. Grimes.Op Ar char
849b50d902SRodney W. Grimes.Oc
859b50d902SRodney W. Grimes.Ek
869b50d902SRodney W. Grimes.Bk -words
879b50d902SRodney W. Grimes.Oo
889b50d902SRodney W. Grimes.Op Fl n
899b50d902SRodney W. Grimes.Op Ar char
909b50d902SRodney W. Grimes.Op Ar width
919b50d902SRodney W. Grimes.Oc
929b50d902SRodney W. Grimes.Ek
939b50d902SRodney W. Grimes.Bk -words
949b50d902SRodney W. Grimes.Op Fl w Ar width
959b50d902SRodney W. Grimes.Ek
969b50d902SRodney W. Grimes.Op -
979b50d902SRodney W. Grimes.Op Ar file ...
989b50d902SRodney W. Grimes.Sh DESCRIPTION
999b50d902SRodney W. GrimesThe
100b637dfa8SPhilippe Charnier.Nm
1019b50d902SRodney W. Grimesutility is a printing and pagination filter for text files.
1029b50d902SRodney W. GrimesWhen multiple input files are specified, each is read, formatted,
1039b50d902SRodney W. Grimesand written to standard output.
1049b50d902SRodney W. GrimesBy default, the input is separated into 66-line pages, each with
1059b50d902SRodney W. Grimes.sp
1069b50d902SRodney W. Grimes.in +2
1079b50d902SRodney W. Grimes.ti -2
1089b50d902SRodney W. Grimes\(bu A 5-line header with the page number, date, time, and
1099b50d902SRodney W. Grimesthe pathname of the file.
1109b50d902SRodney W. Grimes.sp
1119b50d902SRodney W. Grimes.ti -2
1129b50d902SRodney W. Grimes\(bu A 5-line trailer consisting of blank lines.
1139b50d902SRodney W. Grimes.in -2
1149b50d902SRodney W. Grimes.Pp
1159b50d902SRodney W. GrimesIf standard output is associated with a terminal,
1169b50d902SRodney W. Grimesdiagnostic messages are suppressed until the
117b637dfa8SPhilippe Charnier.Nm
1189b50d902SRodney W. Grimesutility has completed processing.
1199b50d902SRodney W. Grimes.Pp
1209b50d902SRodney W. GrimesWhen multiple column output is specified,
1219b50d902SRodney W. Grimestext columns are of equal width.
1229b50d902SRodney W. GrimesBy default text columns are separated by at least one
1239b50d902SRodney W. Grimes.Em <blank> .
1249b50d902SRodney W. GrimesInput lines that do not fit into a text column are truncated.
1259b50d902SRodney W. GrimesLines are not truncated under single column output.
1269b50d902SRodney W. Grimes.Sh OPTIONS
1279b50d902SRodney W. Grimes.Pp
1289b50d902SRodney W. GrimesIn the following option descriptions, column, lines, offset, page, and
1299b50d902SRodney W. Grimeswidth are positive decimal integers and gap is a nonnegative decimal integer.
1309b50d902SRodney W. Grimes.Bl -tag -width 4n
1319b50d902SRodney W. Grimes.It Ar \&+page
1329b50d902SRodney W. GrimesBegin output at page number
1339b50d902SRodney W. Grimes.Ar page
1349b50d902SRodney W. Grimesof the formatted input.
1359b50d902SRodney W. Grimes.It Fl Ar column
1369b50d902SRodney W. GrimesProduce output that is
1379b50d902SRodney W. Grimes.Ar columns
1389b50d902SRodney W. Grimeswide (default is 1) that is written vertically
1399b50d902SRodney W. Grimesdown each column in the order in which the text
1409b50d902SRodney W. Grimesis received from the input file.
1419b50d902SRodney W. GrimesThe options
1429b50d902SRodney W. Grimes.Fl e
1439b50d902SRodney W. Grimesand
1449b50d902SRodney W. Grimes.Fl i
1459b50d902SRodney W. Grimesare assumed.
1469b50d902SRodney W. GrimesThis option should not be used with
1479b50d902SRodney W. Grimes.Fl m .
1489b50d902SRodney W. GrimesWhen used with
1499b50d902SRodney W. Grimes.Fl t ,
1509b50d902SRodney W. Grimesthe minimum number of lines is used to display the output.
1519b50d902SRodney W. Grimes.It Fl a
1529b50d902SRodney W. GrimesModify the effect of the
1539b50d902SRodney W. Grimes.Fl column
1549b50d902SRodney W. Grimesoption so that the columns are filled across the page in a round-robin order
1559b50d902SRodney W. Grimes(e.g., when column is 2, the first input line heads column
1569b50d902SRodney W. Grimes1, the second heads column 2, the third is the second line
1579b50d902SRodney W. Grimesin column 1, etc.).
1589b50d902SRodney W. GrimesThis option requires the use of the
1599b50d902SRodney W. Grimes.Fl column
1609b50d902SRodney W. Grimesoption.
1619b50d902SRodney W. Grimes.It Fl d
1629b50d902SRodney W. GrimesProduce output that is double spaced. An extra
1639b50d902SRodney W. Grimes.Em <newline>
164b637dfa8SPhilippe Charniercharacter is output following every
165b637dfa8SPhilippe Charnier.Em <newline>
166b637dfa8SPhilippe Charnierfound in the input.
1679b50d902SRodney W. Grimes.It Fl e Ar \&[char\&]\&[gap\&]
168b637dfa8SPhilippe CharnierExpand each input
169b637dfa8SPhilippe Charnier.Em <tab>
170b637dfa8SPhilippe Charnierto the next greater column
1719b50d902SRodney W. Grimesposition specified by the formula
1729b50d902SRodney W. Grimes.Ar n*gap+1 ,
1739b50d902SRodney W. Grimeswhere
1749b50d902SRodney W. Grimes.Em n
1759b50d902SRodney W. Grimesis an integer > 0.
1769b50d902SRodney W. GrimesIf
1779b50d902SRodney W. Grimes.Ar gap
1789b50d902SRodney W. Grimesis zero or is omitted the default is 8.
1799b50d902SRodney W. GrimesAll
1809b50d902SRodney W. Grimes.Em <tab>
1819b50d902SRodney W. Grimescharacters in the input are expanded into the appropriate
1829b50d902SRodney W. Grimesnumber of
1839b50d902SRodney W. Grimes.Em <space>s .
1849b50d902SRodney W. GrimesIf any nondigit character,
1859b50d902SRodney W. Grimes.Ar char ,
1869b50d902SRodney W. Grimesis specified, it is used as the input tab character.
1879b50d902SRodney W. Grimes.It Fl F
1889b50d902SRodney W. GrimesUse a
1899b50d902SRodney W. Grimes.Em <form-feed>
1909b50d902SRodney W. Grimescharacter for new pages,
1919b50d902SRodney W. Grimesinstead of the default behavior that uses a
192b637dfa8SPhilippe Charniersequence of
1939b50d902SRodney W. Grimes.Em <newline>
1949b50d902SRodney W. Grimescharacters.
1959b50d902SRodney W. Grimes.It Fl h Ar header
1969b50d902SRodney W. GrimesUse the string
1979b50d902SRodney W. Grimes.Ar header
1989b50d902SRodney W. Grimesto replace the
1999b50d902SRodney W. Grimes.Ar file name
2009b50d902SRodney W. Grimesin the header line.
2019b50d902SRodney W. Grimes.It Fl i Ar \&[char\&]\&[gap\&]
202b637dfa8SPhilippe CharnierIn output, replace multiple
203b637dfa8SPhilippe Charnier.Em <space>s
204b637dfa8SPhilippe Charnierwith
205b637dfa8SPhilippe Charnier.Em <tab>s
206b637dfa8SPhilippe Charnierwhenever two or more
207b637dfa8SPhilippe Charnieradjacent
208b637dfa8SPhilippe Charnier.Em <space>s
209b637dfa8SPhilippe Charnierreach column positions
2109b50d902SRodney W. Grimes.Ar gap+1 ,
2119b50d902SRodney W. Grimes.Ar 2*gap+1 ,
2129b50d902SRodney W. Grimesetc.
2139b50d902SRodney W. GrimesIf
2149b50d902SRodney W. Grimes.Ar gap
2159b50d902SRodney W. Grimesis zero or omitted, default
2169b50d902SRodney W. Grimes.Em <tab>
2179b50d902SRodney W. Grimessettings at every eighth column position
2189b50d902SRodney W. Grimesis used.
2199b50d902SRodney W. GrimesIf any nondigit character,
2209b50d902SRodney W. Grimes.Ar char ,
2219b50d902SRodney W. Grimesis specified, it is used as the output
2229b50d902SRodney W. Grimes.Em <tab>
2239b50d902SRodney W. Grimescharacter.
2244bf9895eSAndrey A. Chernov.It Fl L Ar locale
2254bf9895eSAndrey A. ChernovUse
2264bf9895eSAndrey A. Chernov.Ar locale
2274bf9895eSAndrey A. Chernovspecified as argument instead of one found in environment.
2284bf9895eSAndrey A. ChernovUse "C" to reset locale to default.
2299b50d902SRodney W. Grimes.It Fl l Ar lines
2309b50d902SRodney W. GrimesOverride the 66 line default and reset the page length to
2319b50d902SRodney W. Grimes.Ar lines .
2329b50d902SRodney W. GrimesIf
2339b50d902SRodney W. Grimes.Ar lines
2349b50d902SRodney W. Grimesis not greater than the sum of both the header and trailer
2359b50d902SRodney W. Grimesdepths (in lines), the
236b637dfa8SPhilippe Charnier.Nm
2379b50d902SRodney W. Grimesutility suppresses output of both the header and trailer, as if the
2389b50d902SRodney W. Grimes.Fl t
2399b50d902SRodney W. Grimesoption were in effect.
2409b50d902SRodney W. Grimes.It Fl m
2419b50d902SRodney W. GrimesMerge the contents of multiple files.
2429b50d902SRodney W. GrimesOne line from each file specified by a file operand is
2439b50d902SRodney W. Grimeswritten side by side into text columns of equal fixed widths, in
2449b50d902SRodney W. Grimesterms of the number of column positions.
2459b50d902SRodney W. GrimesThe number of text columns depends on the number of
2469b50d902SRodney W. Grimesfile operands successfully opened.
2479b50d902SRodney W. GrimesThe maximum number of files merged depends on page width and the
2489b50d902SRodney W. Grimesper process open file limit.
2499b50d902SRodney W. GrimesThe options
2509b50d902SRodney W. Grimes.Fl e
2519b50d902SRodney W. Grimesand
2529b50d902SRodney W. Grimes.Fl i
2539b50d902SRodney W. Grimesare assumed.
2549b50d902SRodney W. Grimes.It Fl n Ar \&[char\&]\&[width\&]
2559b50d902SRodney W. GrimesProvide
2569b50d902SRodney W. Grimes.Ar width
2579b50d902SRodney W. Grimesdigit line numbering.
2589b50d902SRodney W. GrimesThe default for
2599b50d902SRodney W. Grimes.Ar width ,
2609b50d902SRodney W. Grimesif not specified, is 5.
2619b50d902SRodney W. GrimesThe number occupies the first
2629b50d902SRodney W. Grimes.Ar width
2639b50d902SRodney W. Grimescolumn positions of each text column or each line of
2649b50d902SRodney W. Grimes.Fl m
2659b50d902SRodney W. Grimesoutput.
2669b50d902SRodney W. GrimesIf
2679b50d902SRodney W. Grimes.Ar char
2689b50d902SRodney W. Grimes(any nondigit character) is given, it is appended to the line number to
2699b50d902SRodney W. Grimesseparate it from whatever follows. The default for
2709b50d902SRodney W. Grimes.Ar char
2719b50d902SRodney W. Grimesis a
2729b50d902SRodney W. Grimes.Em <tab> .
2739b50d902SRodney W. GrimesLine numbers longer than
2749b50d902SRodney W. Grimes.Ar width
2759b50d902SRodney W. Grimescolumns are truncated.
2769b50d902SRodney W. Grimes.It Fl o Ar offset
2779b50d902SRodney W. GrimesEach line of output is preceded by
2789b50d902SRodney W. Grimes.Ar offset
2799b50d902SRodney W. Grimes.Em <spaces>s .
2809b50d902SRodney W. GrimesIf the
2819b50d902SRodney W. Grimes.FL o
2829b50d902SRodney W. Grimesoption is not specified, the default is zero.
2839b50d902SRodney W. GrimesThe space taken is in addition to the output line width.
2849b50d902SRodney W. Grimes.It Fl r
2859b50d902SRodney W. GrimesWrite no diagnostic reports on failure to open a file.
2869b50d902SRodney W. Grimes.It Fl s Ar char
2879b50d902SRodney W. GrimesSeparate text columns by the single character
2889b50d902SRodney W. Grimes.Ar char
2899b50d902SRodney W. Grimesinstead of by the appropriate number of
2909b50d902SRodney W. Grimes.Em <space>s
2919b50d902SRodney W. Grimes(default for
2929b50d902SRodney W. Grimes.Ar char
2939b50d902SRodney W. Grimesis the
2949b50d902SRodney W. Grimes.Em <tab>
2959b50d902SRodney W. Grimescharacter).
2969b50d902SRodney W. Grimes.It Fl t
2979b50d902SRodney W. GrimesPrint neither the five-line identifying
2989b50d902SRodney W. Grimesheader nor the five-line trailer usually supplied for each page.
2999b50d902SRodney W. GrimesQuit printing after the last line of each file without spacing to the
3009b50d902SRodney W. Grimesend of the page.
3019b50d902SRodney W. Grimes.It Fl w Ar width
3029b50d902SRodney W. GrimesSet the width of the line to
3039b50d902SRodney W. Grimes.Ar width
3049b50d902SRodney W. Grimescolumn positions for multiple text-column output only.
3059b50d902SRodney W. GrimesIf the
3069b50d902SRodney W. Grimes.Fl w
3079b50d902SRodney W. Grimesoption is not specified and the
3089b50d902SRodney W. Grimes.Fl s
3099b50d902SRodney W. Grimesoption is not specified, the default width is 72.
3109b50d902SRodney W. GrimesIf the
3119b50d902SRodney W. Grimes.Fl w
3129b50d902SRodney W. Grimesoption is not specified and the
3139b50d902SRodney W. Grimes.Fl s
3149b50d902SRodney W. Grimesoption is specified, the default width is 512.
3159b50d902SRodney W. Grimes.It Ar file
3169b50d902SRodney W. GrimesA pathname of a file to be printed.
3179b50d902SRodney W. GrimesIf no
3189b50d902SRodney W. Grimes.Ar file
3199b50d902SRodney W. Grimesoperands are specified, or if a
3209b50d902SRodney W. Grimes.Ar file
3219b50d902SRodney W. Grimesoperand is
3229b50d902SRodney W. Grimes.Sq Fl ,
3239b50d902SRodney W. Grimesthe standard input is used.
3249b50d902SRodney W. GrimesThe standard input is used only if no
3259b50d902SRodney W. Grimes.Ar file
3269b50d902SRodney W. Grimesoperands are specified, or if a
3279b50d902SRodney W. Grimes.Ar file
3289b50d902SRodney W. Grimesoperand is
3299b50d902SRodney W. Grimes.Sq Fl .
3309b50d902SRodney W. Grimes.El
3319b50d902SRodney W. Grimes.Pp
3329b50d902SRodney W. GrimesThe
3339b50d902SRodney W. Grimes.Fl s
3349b50d902SRodney W. Grimesoption does not allow the option letter to be separated from its
3359b50d902SRodney W. Grimesargument, and the options
3369b50d902SRodney W. Grimes.Fl e ,
3379b50d902SRodney W. Grimes.Fl i ,
3389b50d902SRodney W. Grimesand
3399b50d902SRodney W. Grimes.Fl n
3409b50d902SRodney W. Grimesrequire that both arguments, if present, not be separated from the option
3419b50d902SRodney W. Grimesletter.
3429b50d902SRodney W. Grimes.Sh ERRORS
3439b50d902SRodney W. Grimes.Pp
3449b50d902SRodney W. GrimesIf
345b637dfa8SPhilippe Charnier.Nm
3469b50d902SRodney W. Grimesreceives an interrupt while printing to a terminal, it
3479b50d902SRodney W. Grimesflushes all accumulated error messages to the screen before
3489b50d902SRodney W. Grimesterminating.
3499b50d902SRodney W. Grimes.Pp
3509b50d902SRodney W. GrimesThe
351b637dfa8SPhilippe Charnier.Nm
3529b50d902SRodney W. Grimesutility exits 0 on success, and 1 if an error occurs.
3539b50d902SRodney W. Grimes.Pp
3549b50d902SRodney W. GrimesError messages are written to standard error during the printing
3559b50d902SRodney W. Grimesprocess (if output is redirected) or after all successful
3569b50d902SRodney W. Grimesfile printing is complete (when printing to a terminal).
3579b50d902SRodney W. Grimes.Sh SEE ALSO
3589b50d902SRodney W. Grimes.Xr cat 1 ,
3599b50d902SRodney W. Grimes.Xr more 1
3609b50d902SRodney W. Grimes.Sh STANDARDS
3619b50d902SRodney W. GrimesThe
362b637dfa8SPhilippe Charnier.Nm
3639b50d902SRodney W. Grimesutility is
3649b50d902SRodney W. Grimes.St -p1003.2
3659b50d902SRodney W. Grimescompatible.
366b8923d4cSWolfram Schneider.Sh HISTORY
367b8923d4cSWolfram SchneiderA
368b8923d4cSWolfram Schneider.Nm
369b8923d4cSWolfram Schneidercommand appeared in
370b8923d4cSWolfram Schneider.At v1 .
371