a2ps(1)

NAME
a2ps - an ASCII to PostScript transformer

SYNOPSIS
a2ps [ -u | -v | -h | -o file | -p format | -l lines | -s stretch | -a horizontal vertical ] ... [ -- ] [ file ] ...

DESCRIPTION
This manual page documents a2ps, an ASCII to PostScript (level 1 compliant) transformer. If no files are given standard input is used. By default output is directed to standard output.

OPTIONS

-u  Print a usage message on standard output and exit successfully.

-v  Print version number and copyright information.

-h  Suppress the generation of page headers.

-o file
    Send output to file or filter file. If file is of the form "|filter", output will be send to the standard input of filter.

-p format
    Use page format format. The page format must be "A4" or "Letter". Default is "A4". Europeans will normally want "A4", while Americans will probably want to use "Letter".

-l lines
    Set page length to lines lines. Page length must be greater than 1, default is 66. When a page length is given greater then 72, a warning will be given because the lines may run into each other. A warning will also be given when the page length is less than 60. In that case the line spacing might hurt your eyes :-).

-s stretch
    Stretch the line spacing by stretch percent. Although any value above -100 percent is allowed, it is just meant to be for fine adjustments with a value near the default of 0.0 percent. A warning will be given when stretch is more than 5 percent off the default.

-a horizontal vertical
    Adjust the page by horizontal points to the right and vertical points up. Points are measured in PostScript points: 1/72 inch. Although any value is allowed, this option is meant to be for fine adjustment with values near the defaults of 0.0 points. A warning will be given if either horizontal or vertical deviates more than 35 points of the default.

--  No more options. All arguments following this option will be treated as files.

MISCELLANEOUS
The program make use of environment variables USER (or LOGNAME if USER does not exist) and HOST to fill in some nice values in the PostScript header. If these environment variables do not exist, default values will be used.

When the program does not give any warnings, the output is fully level 1 compliant PostScript code. In the case of a warning, the code might still be compliant, but you must check it yourself.

The program understands the following ASCII control characters: \t, \b, \r, \n, and \f. It can also process characters with the high bit on. It uses the Standard Text Encoding PostScript font.

Oh, one thing. This program do not make text italic nor does it make text bold. IMHO that is not the job of an ASCII to PostScript transformer.

AUTHOR
If you want to get in touch with me, just send an email to "J.P.M.deVreught@cs.tudelft.nl (Hans de Vreught)". Bug reports are welcome (well, not really ;-). Do not forget to mention that this program is from the package "ascii2postscript-1.4.4.tar.gz". FYI, this program is copyrighted by me, however you can do with it what you want under the GNU General Public License.