1A2PS(1)                               FSF                              A2PS(1)
2
3
4

NAME

6       a2ps - format files for printing on a PostScript printer
7

SYNOPSIS

9       a2ps OPTION]... [FILE]...
10

DESCRIPTION

12       Convert FILE(s) or standard input to PostScript.
13
14       Mandatory  arguments  to  long  options are mandatory for short options
15       too.  Long options marked with * require a yes/no argument, correspond‐
16       ing short options stand for `yes'.
17
18   Tasks:
19       --version
20              display version
21
22       --help display this help
23
24       --guess
25              report guessed types of FILES
26
27       --which
28              report the full path of library files named FILES
29
30       --glob report the full path of library files matching FILES
31
32       --list=defaults
33              display default settings and parameters
34
35       --list=TOPIC
36              detailed  list on TOPIC (delegations, encodings, features, vari‐
37              ables, media,  ppd,  printers,  prologues,  style-sheets,  user-
38              options)
39
40       After having performed the task, exit successfully.  Detailed lists may
41       provide additional help on specific features.
42
43   Global:
44       -q, --quiet, --silent
45              be really quiet
46
47       -v, --verbose=LEVEL]
48              set verbosity on, or to LEVEL
49
50       -=, --user-option=OPTION
51              use the user defined shortcut OPTION
52
53       --debug
54              enable debugging features
55
56       -D, --define=KEY[:VALUE]
57              unset variable KEY or set to VALUE
58
59   Sheets:
60       -M, --medium=NAME
61              use output medium NAME
62
63              The default behaviour is to use the locale category LC_PAPER  to
64              determine  the  medium  to  use.   Note that this information is
65              obtained from environment variables which may not be set  up  in
66              non-interactive environments (such as in a cron job).
67
68       -r, --landscape
69              print in landscape mode
70
71       -R, --portrait
72              print in portrait mode
73
74       --columns=NUM
75              number of columns per sheet
76
77       --rows=NUM
78              number of rows per sheet
79
80       --major=DIRECTION
81              first fill (DIRECTION=) rows, or columns
82
83       -1, -2, ..., -9
84              predefined font sizes and layouts for 1.. 9 virtuals
85
86       -A, --file-align=MODE
87              align  separate files according to MODE (fill, rank page, sheet,
88              or a number)
89
90       -j, --borders*
91              print borders around columns
92
93       --margin=NUM]
94              define an interior margin of size NUM
95
96       The options -1.. -9 affect several primitive parameters to set up  pre‐
97       defined layouts with 80 columns.  Therefore the order matters: `-R -f40
98       -2' is equivalent to `-2'.  To modify the layout, use `-2Rf40', or com‐
99       pose primitive options (`--columns', `--font-size' etc.).
100
101   Virtual pages:
102       --line-numbers=NUM
103              precede each NUM lines with its line number
104
105       -C     alias for --line-numbers=5
106
107       -f, --font-size=SIZE
108              use font SIZE (float) for the body text
109
110       -L, --lines-per-page=NUM
111              scale the font to print NUM lines per virtual
112
113       -l, --chars-per-line=NUM
114              scale the font to print NUM columns per virtual
115
116       -m, --catman
117              process FILE as a man page (same as -L66)
118
119       -T, --tabsize=NUM
120              set tabulator size to NUM
121
122       --non-printable-format=FMT specify how non-printable chars are printed
123
124   Headings:
125       -B, --no-header
126              no page headers at all
127
128       -b, --header=TEXT]
129              set page header
130
131       -u, --underlay=TEXT]
132              print TEXT under every page
133
134       --center-title=TEXT]
135              set page title to TITLE
136
137       --left-title=TEXT]
138              set left and right page title to TEXT
139
140       --right-title=TEXT]
141
142       --left-footer=TEXT]
143              set sheet footers to TEXT
144
145       --footer=TEXT]
146
147       --right-footer=TEXT]
148
149       The TEXTs may use special escapes.
150
151   Input:
152       -a, --pages=RANGE]
153              select the pages to print
154
155       -c, --truncate-lines*
156              cut long lines
157
158       -i, --interpret*
159              interpret tab, bs and ff chars
160
161       --end-of-line=TYPE
162              specify the eol char (TYPE: r, n, nr, rn, any)
163
164       -X, --encoding=NAME
165              use input encoding NAME
166
167       -t, --title=NAME
168              set the name of the job
169
170       --stdin=NAME
171              set the name of the input file stdin
172
173       --print-anyway*
174              force binary printing
175
176       -Z, --delegate*
177              delegate files to another application
178
179       --toc=TEXT]
180              generate a table of content
181
182       When delegations are enabled, a2ps may use other applications to handle
183       the processing of files that should not be printed as raw  information,
184       e.g., HTML PostScript, PDF etc.
185
186   Pretty-printing:
187       -E, --pretty-print=LANG]
188              enable pretty-printing (set style to LANG)
189
190       --highlight-level=LEVEL
191              set pretty printing highlight LEVEL LEVEL can be none, normal or
192              heavy
193
194       -g     alias for --highlight-level=heavy
195
196       --strip-level=NUM
197              level of comments stripping
198
199   Output:
200       -o, --output=FILE
201              leave output to file FILE.  If FILE is `-', leave output to std‐
202              out.
203
204       --version-control=WORD
205              override the usual version control
206
207       --suffix=SUFFIX
208              override the usual backup suffix
209
210       -P, --printer=NAME
211              send output to printer NAME
212
213       -d     send output to the default printer
214
215   PostScript:
216       --prologue=FILE
217              include FILE.pro as PostScript prologue
218
219       --ppd=KEY]
220              automatic PPD selection or set to KEY
221
222       -n, --copies=NUM
223              print NUM copies of each page
224
225       -s, --sides=MODE
226              set  the  duplex  MODE (`1' or `simplex', `2' or `duplex', `tum‐
227              ble')
228
229       -S, --setpagedevice=K[:V]
230              pass a page device definition to output
231
232       --statusdict=K[:[:]V]
233              pass a statusdict definition to the output
234
235       -k, --page-prefeed
236              enable page prefeed
237
238       -K, --no-page-prefeed
239              disable page prefeed
240
241       By default a2ps is tuned to do what you  want  to,  so  trust  it.   To
242       pretty print the content of the `src' directory and a table of content,
243       and send the result to the printer `lw',
244
245              $ a2ps -P lw --toc src/*
246
247       To process the files `sample.ps'  and  `sample.html'  and  display  the
248       result,
249
250              $ a2ps -P display sample.ps sample.html
251
252       To process a mailbox in 4 up,
253
254              $ a2ps -=mail -4 mailbox
255
256       To print as a booklet on the default printer, which is Duplex capable,
257
258              $ a2ps -=book paper.dvi.gz -d
259
260       News,          updates         and         documentation:         visit
261       http://www.inf.enst.fr/~demaille/a2ps/.
262

AUTHOR

264       Written by Akim Demaille, Miguel Santana.
265

REPORTING BUGS

267       Report bugs to <bug-a2ps@gnu.org>.
268

COPYRIGHT

270       Copyright © 1988-1993 Miguel Santana
271       Copyright © 1995-2000 Akim Demaille, Miguel Santana
272       This is free software; see the source for copying conditions.  There is
273       NO  warranty;  not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
274       PURPOSE.
275

SEE ALSO

277       a2ps(1), card(1), fixps(1), pdiff(1), psset(1), texi2dvi4a2ps(1).
278
279       The full documentation for a2ps is maintained as a Texinfo manual.   If
280       the  info  and  a2ps  programs are properly installed at your site, the
281       command
282
283              info a2ps
284
285       should give you access to the complete manual.
286
287
288
289GNU a2ps 4.13                    February 2000                         A2PS(1)