r.a2ps
r.a2ps - formats an ascii file for printing on a postscript
printer using a2ps. It is recommended to use this binary as
it provides a more consistent output as a2ps is platform dependant.
DOCUMENTATION:
pollux 5% r.a2ps -h
Usage: r.a2ps [options] [ f1 [ [H_opt] f2 ...] ]
options = -#num number of copies to print
-? print this information
-b -nb force (DON'T FORCE) binary printing
-c -nc allow (DON'T ALLOW) two files on the same sheet
-d -nd PRINT (don't print) current date at the bottom
-Fnum font size, num is a float number
-f -nf FOLD (don't fold) lines
-Hstr use str like header title for subsequent files
-nH don't print any header
-h print this information
-Ifile include this file as a2ps prologue
-i -ni INTERPRET (don't interpret) tab, bs and ff chars
-lnum use num lines per page
-m process the file as a man
-n -nn NUMBER (don't number) line files
-Pprinter -nP SEND (don't send) directly to the printer
(with options '-l' and -Pprinter)
-p -np print in portrait (LANDSCAPE) mode
-r -nr RESTART (don't restart) page number after each file
-s -ns PRINT (don't print) surrounding borders
-tnum set tab size to n
-v -nv VISIBLE (blank) display of unprintable chars
-w -nw wide (NARROW, 2-up if landscape)
The following is from a "man" of a2ps:
A2PS(1L) EP/IX Reference Manual A2PS(1L)
NAME
a2ps - formats an ascii file for printing on a postscript
printer
SYNOPSIS
a2ps [ -#num ] [ -? ] [ -b ] [ -c ] [ -d ] [ -Fnum ] [ -f ]
[ -Hstr ] [ -h ] [ -Ifile ] [ -i ] [ -lnum ] [ -m ] [ -n ] [
-n{bcdfHinPprsvw} ] [ -Pprinter ] [ -p ] [ -r ] [ -s ] [ -
tnum ] [ -v ] [ -w ] [ file1 [ [ -Hstr ] file2 ... ]
DESCRIPTION
a2ps formats each named file for printing in a postscript
printer; if no file is given, a2ps reads from the standard
input. The output is sent to lpr or to stdout. The format
plied header), line numbering, etc. This is very useful for
making archive listings of programs.
Options offered by a2ps are the following:
-? Print usage information.
-#num To get multiple copies of output, where num is the
number of copies desired of each file named. By
default, you get only one copy.
-b Force printing binary files. By default, binary files
option).
-c Compact mode for a sequence of files. This option
allows the printing of two files in the same sheet:
sheet).
-d Print the current date and time at the bottom of the
no surrounding border and the no header options.
-Fnum Changes font size to this value. Default values for
font size are 6.8 in landscape mode and 9.0 in por-
trait mode. Try other sizes if you think that these
values are too small (or big).
-f Fold lines too large to be printed inside the borders
(default option). Max line size depends on format and
font size used and whether line numbering has been
suppressed.
A2PS(1L) EP/IX Reference Manual A2PS(1L)
-Htext
headers for printing subsequent files. Additional -H
directives can be mixed in with the filenames. Warn-
ing: multiple files printed between -H directives will
all have the same heading (but will still be printed
-h Print usage information.
-Ifile
Use the specified file as the postscript prologue for
a2ps.
-i Interpret TAB, BS and FF characters (default option).
TAB is replaced by enough spaces to reach next tab
stop while BS and FF have their meanings.
This is useful for printing preformatted documents
ing of the font size will be suppressed if this option
is used with option -fnum. The minimum number of
a number less than 40 is supplied, scaling will be
turned off and a warning message is printed on the
terminal.
no line numbering and possible bolding and underlining
sequences. The understanding of bolding and underlin-
ing is there by default even if -m is not specified.
-n Output lines are preceded by line numbers, numbered
sequentially from 1.
-nb Don't print binary files (default option). To detect
such a file we make use of a very simple heuristic: if
non-printing characters, it's a binary file. First
-nc Don't use compact mode for a sequence of files. The
beginning of each file will be printed in a new sheet.
-nd Don't print the current date and time in the footer.
-nf Truncate lines too large (don't fold).
A2PS(1L) EP/IX Reference Manual A2PS(1L)
-ni Don't interpret TAB, BS and FF characters. They will
be printed according to -v option.
-nn Don't number output lines (default option).
-nP Send output to stdout. Default is to send output
directly to the printer
in landscape mode.
-nr Sheet numbering (see -r option) must be continue for
all files (don't reset on new file).
-nv Replace non-printing characters by a space.
-nw Don't use wide format (see -w option).
-Pprinter
Send output to the named printer. The default option
is send to the default printer.
sheet. The default option is to use landscape mode
may not be used with the -w option.
-r Reset sheet numbering for each new file (default
option). Sheet numbering is used to number physical
fied).
-tnum Set TAB size to num (default 8). This option is
ignored if -ni is specified (see below).
-v Replace non-printing characters so that they are visi-
ble and easy to identify (default option). Control
characters (ascii codes lower than 0x20) are printed
like ^X for ctrl-x; the delete character (hex 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. TAB, BS and FF are han-
dled like non-printing characters if -ni option was
taken.
A2PS(1L) EP/IX Reference Manual A2PS(1L)
option may not be used with the -p option.
USAGE
a2ps generates postcript to its standard output. The user
could redirect this output to a file, pipe it directly to a
print command (like lpr), or to another filter for further
processing. By default, a2ps pipes directly the output to
the print command (see -P option).
a2ps -nP file1 > file2
a2ps -nP -p file1 | psnup -n4 | lpr -l -Pps
Don't forget -l option in lpr , if you want that lpr inter-
prets your postscript program rather than merely printing it
as ascii text.
This filter must be used only with text files. Avoid spe-
cially output from TeX, troff or any other such text for-
matters.
SEE ALSO
tgrind(1) lpr(1)
AUTHORS
Evan Kirshenbaum (evan@csli) for the initial version.
Miguel Santana (miguel@imag.imag.fr) for versions 1.0, 2.0,
3.0 and 4.0.
CONTRIBUTORS
Oscar Nierstrasz (oscar@cui.uucp)
Tim Clark (T.Clark@warwick.ac.uk)
Henk Tullemans (tullemans@apolloway.prl.philips.nl)
Johan Vromans (jv@mh.nl)
Craig Stevenson (craig.r.stevenson@att.com)
John Macdonald (jmm@eci386.uucp)
Huub van de Wetering (wstahw@lso.win.tue.nl)