PR(1,C) AIX Commands Reference PR(1,C) ------------------------------------------------------------------------------- pr PURPOSE Writes a file to standard output. SYNTAX +- -l66 -o0 +1 -+ +-- -1 --------------------------------+ pr ---| +---------+ |---| +- -m -------------+ +-----------+ |---> +--| -d |--+ +-| +------+ |---| |-+ A| -f || +- -num --| |-+ +- -s char -+ || -l num || +- -a -+ || -o num || || -p || || -r || || -w num || || + num || |+---------+| +-----------+ +-----------------+ +------------------------------+ >---| one of |---| +--------+ +-- 5 --+ |---> | +-------------+ | +- -n --| |---| |-+ +-| -t |-+ +- char -+ +- num -+ | -h "string" | +-------------+ +---------------------------------+ +--------+ >---| one of |---| |---| | +----+ +--------+ +-- 8 --+ | +- file -+ +-| -e |---|1 |---|1 |-+ A | ^| -i | +- char -+ +- num -+| +------+ |+----+ | +-------------------------------+ ----------------- 1 Do not put a blank between these items. DESCRIPTION The pr command writes file to the standard output. If you do not specify file or if file is a - (minus), pr reads standard input. A heading that contains the page number, date, time, and the name of the file separates the output into pages. Processed November 8, 1990 PR(1,C) 1 PR(1,C) AIX Commands Reference PR(1,C) Unless specified, columns are of equal width and separated by at least one space. Lines that are too long for the page width are cut off. If the standard output is a work station, pr does not display any error messages until it has ended. FLAGS -a Displays multi-column output across the page. -d Double-spaces the output. -e[char][num] Expands tabs to character positions num+1, 2*num+1, 3*num+1, and so on. The default value of num is 8. Tab characters in the input expand to the appropriate number of spaces to line up with the next tab setting. If you specify char (any character other than a digit) that character becomes the input tab character. The default value of char is the ASCII TAB character. -f Uses a form-feed character to advance to a new page. (Otherwise pr issues a sequence of line-feed characters.) Pauses before beginning the first page if the standard output is a work station. -h "string" Displays string as the page header instead of the file name. The flag and string should be separated by a blank. -i[char][num] In the output, replaces white space wherever possible by inserting tabs to character positions num+1, 2*num+1, 3*num+1, and so on. The default value of num is 8. If you specify char (any character other than a digit), that character becomes the output tab character. (The default value of char is the ASCII TAB character.) -lnum Sets the length of a page to num lines (the default is 66). -m Combines and writes all files at the same time, with each file in a separate column. (This overrides the -num and -a flags). -n[char][num] Provides num-digit line numbering (the default value of num is 5). The number occupies the first num+1 character positions of each column of normal output or each line of -m output. If you specify char (any character other than a digit), that character is added to the line number to separate it from whatever follows (the default value of char is an ASCII TAB character). Processed November 8, 1990 PR(1,C) 2 PR(1,C) AIX Commands Reference PR(1,C) -onum Indents each line by num character positions (the default is 0). The number of character positions per line is the sum of the width and offset. -p Pauses before beginning each page if the output is directed to a work station. (pr sounds the alarm at the workstation and waits for you to press the Enter key.) -r Does not display diagnostic messages if the system cannot open files. -schar Separates columns by the single character char instead of by the appropriate number of spaces (the default for char is an ASCII TAB character). -t Does not display the five-line identifying header and the five-line footer. Stops after the last line of each file without spacing to the end of the page. -wnum Sets the width of a line to num character positions (the default value is 72 for equal-width multi-column output, no limit otherwise). -num Produces num-column output (the default is 1). The -e and -i flags are assumed for multi-column output. +num Begins the display with page num (the default value is 1). EXAMPLES 1. To print a file with headings and page numbers on the printer: pr prog.c | print This adds page headings to "prog.c" and sends it to the print command. The heading consists of the date the file was last modified, the file name, and the page number. 2. To specify a title: pr -h "MAIN PROGRAM" prog.c | print This prints "prog.c" with the title "MAIN PROGRAM" in place of the file name. The modification date and page number are still printed. 3. To print a file in multiple columns: pr -3 word.lst | print This prints the file "word.lst" in three vertical columns. Processed November 8, 1990 PR(1,C) 3 PR(1,C) AIX Commands Reference PR(1,C) 4. To print several files side-by-side on the paper: pr -m -h "Members and Visitors" member.lst visitor.lst | print This prints "member.lst" and "visitor.lst" side by side with the title "Members and Visitors". 5. To modify a file for later use: pr -t -e prog.c > prog.notab.c This replaces tab characters in "prog.c" with blanks and puts the result in "prog.notab.c". Tab positions are at columns 9, 17, 25, 33, .... The "-e" tells pr to replace the tab characters; the "-t" suppresses the page headings. RELATED INFORMATION See the following command: "cat." Processed November 8, 1990 PR(1,C) 4