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