va2ps(1) CLIX va2ps(1)
NAME
va2ps, xa2ps - Formats an ASCII file for printing on a PostScript printer
SYNOPSIS
va2ps [-#num] [-?] [-b] [-B] [-Fnum] [-h] [-l] [-L] [-n{fhinsvw}] [-
O"string"] [-p] [-qqueue] [-tnum] [-T"string"] [-u] [-U] [-w] [file] ...
xa2ps [-#num] [-?] [-b] [-B] [-Fnum] [-h] [-l] [-L] [-n{fhinsvw}] [-
O"string"] [-p] [-qqueue] [-tnum] [-T"string"] [-u] [-U] [-w] [file] ...
FLAGS
-#num Prints multiple copies of output. The num is the number of
copies desired of each file named. By default, only one copy
of each file is printed.
-? Prints help information.
-b Forces the printing of binary files. By default, binary files
printing is stopped before second page.
-B Generates output for B-sized (11-inch by 17-inch) paper.
-Fnum Changes font size to num. Default values for font size are
6.8 in landscape mode and 9.0 in portrait mode.
-h Prints help information.
-l Sets the number of lines per page.
-L Prints the Intergraph logo at the bottom of each page.
-nf Cuts lines that are too long. Does not fold the lines inside
the borders.
-nh Does not print page headers.
-ni Does not interpret tab, backspace and form feed characters.
-nn Does not number output lines.
-ns Does not print surrounding page borders.
-nv Replaces non-printing characters with spaces.
-nw Does not use the wide page format. (See also the -w flag
description.)
-O"string" Overlays the specified string on each page. Useful for
2/94 - Intergraph Corporation 1
va2ps(1) CLIX va2ps(1)
making drafts and confidential material.
-p Prints files in portrait mode, with one logical page for each
physical sheet of paper. (The default is to use landscape
mode and print two logical pages on a physical sheet.) This
flag cannot be used with the -w flag.
-qqueue Specifies the queue name to which output is sent. This flag
can be used only with the -U flag.
-tnum Sets the tab size to num. The default is 8. This flag is
ignored if the -ni flag is specified.
-T"string" Prints the user-specifed string as the title of each page.
-u Prints the usr@node information in the title.
-U Displays the User Interface menu. This flag presents a menu
for selecting the most popular flags of va2ps and xa2ps.
-w Uses wide format pages. This will result in only one logical
page per physical sheet but in landscape mode. This flag may
not be used with the -p flag.
DESCRIPTION
The va2ps and xa2ps commands format each named file for printing on a
PostScript printer. (The xa2ps command is used with X Window systems.)
If no file is specified or a dash (-) is used for the filename, the
command reads from stdin. The default format is two logical pages on each
physical page, in landscape orientation, borders surrounding pages,
headers with the page number, printing date, and file name, and line
numbering. This format is useful to archive listings of programs.
The va2ps and xa2ps commands send a formatted file to stdout; however, if
the -U flag is used to start the user interface, the output is piped to
the selected queue. The output can be redirected to a file, piped
directly to a print command, or piped to another filter for further
processing.
Non-printing characters are replaced so that they are visible and easy to
identify. Control characters (ASCII codes lower than 0x20) are printed
like ^X for the delete character (0x3f) is printed as ^?. Non-ASCII
characters (with the high bit set) are printed as M- (for meta) followed
by the character of the low 7 bits. The tab, backspace and form feed are
handled like non-printing characters if -ni flag is specifed.
EXAMPLES
In all of the examples, the va2ps command is used. The x2aps command is
used exactly the same way as the va2ps command; substitute xa2ps for
2 Intergraph Corporation - 2/94
va2ps(1) CLIX va2ps(1)
va2ps in the examples.
1. This example brings up the user interface menu for selecting
formatting options.
va2ps -U
2. This example selects the queue print_it to use with the user
interface.
va2ps -U -qprint_it
3. This example formats the file this.file and redirects the output to
the file fixed.file.
va2ps this.file > fixed.file
4. This example formats the file a.file and pipes the output to the lpr
command for printing. The -l flag for lpr must be used so that lpr
will interpret the PostScript program. In this example, the printer
named cedar is specifed with the -P flag of the lpr command.
va2ps a.file | lpr -l -Pcedar
5. This example formats the file test.file and pipes the output to the
qpr command for printing. The -t flag for qpr must be used so that
qpr will interpret the PostScript program. In this example, the print
queue named maple is specified with the -q flag of the qpr command.
va2ps test.file | qpr -t script -q maple
6. This example sets the title to be Rough Draft for the file
/usr/john/draft. The output is piped to the qpr command. The -t flag
must be used so that qpr will interpret the PostScript program. The
print queue maple is specifed with the -q flag of the qpr command.
va2ps -T"Rough Draft" /usr/john/draft | qpr -t script -q maple
NOTES
The -l flag for lpr or the -t flag of qpr must be used to interpret the
PostScript program.
This command must be used only with text files. Avoid output from TeX,
troff, or any other such text formatters.
2/94 - Intergraph Corporation 3
va2ps(1) CLIX va2ps(1)
EXIT VALUES
The va2ps and xa2ps commands exit with a value of 1 if an error occurs.
RELATED INFORMATION
Commands: lpr(1), qpr(1)
4 Intergraph Corporation - 2/94