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

AUTHOR

267       Written by Akim Demaille, Miguel Santana.
268

REPORTING BUGS

270       Report bugs to <bug-a2ps@gnu.org>.
271

COPYRIGHT

273       Copyright © 1988-1993 Miguel Santana
274       Copyright © 1995-2000 Akim Demaille, Miguel Santana
275       Copyright © 2007- Akim Demaille, Miguel Santana and Masayuki Hatta
276       This is free software; see the source for copying conditions.  There is
277       NO warranty; not even for MERCHANTABILITY or FITNESS FOR  A  PARTICULAR
278       PURPOSE.
279

SEE ALSO

281       a2ps(1), card(1), fixps(1), pdiff(1), psset(1), texi2dvi4a2ps(1).
282
283       The  full documentation for a2ps is maintained as a Texinfo manual.  If
284       the info and a2ps programs are properly installed  at  your  site,  the
285       command
286
287              info a2ps
288
289       should give you access to the complete manual.
290
291
292
293GNU a2ps 4.14                    December 2007                         A2PS(1)