.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.1.
.TH A2PS "1" "June 2023" "GNU a2ps 4.15.4" "User Commands"
.SH NAME
a2ps \- format files for printing on a PostScript printer
.SH SYNOPSIS
.B a2ps
[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]...
.SH DESCRIPTION
.\" Add any additional description here
.PP
Convert FILE(s) or standard input to PostScript.  By default, the output is
sent to the default printer.  An output file may be specified with \fB\-o\fR.
.PP
Mandatory arguments to long options are mandatory for short options too.
Long options marked with `*' require a yes/no argument, corresponding short
options stand for `yes'.
.PP
Tasks:
.TP
\fB\-\-version\fR
display version
.TP
\fB\-\-help\fR
display this help
.TP
\fB\-\-guess\fR
report guessed types of FILES
.TP
\fB\-\-which\fR
report the full path of library files named
FILES
.TP
\fB\-\-glob\fR
report the full path of library files matching
FILES
.TP
\fB\-\-list\fR=\fI\,defaults\/\fR
display default settings and parameters
.TP
\fB\-\-list\fR=\fI\,TOPIC\/\fR
detailed list on TOPIC (delegations,
encodings, features, variables, media, ppd,
printers, prologues, style\-sheets,
user\-options)
.PP
After having performed the task, exit successfully.  Detailed lists may provide
additional help on specific features.
.PP
Global:
.TP
\fB\-q\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR
be really quiet
.TP
\fB\-v\fR, \fB\-\-verbose\fR[=\fI\,LEVEL\/\fR]
set verbosity on, or to LEVEL
.TP
\fB\-=\fR, \fB\-\-user\-option\fR=\fI\,OPTION\/\fR
use the user defined shortcut OPTION
.TP
\fB\-\-debug\fR
enable debugging features
.TP
\fB\-D\fR, \fB\-\-define\fR=\fI\,KEY[\/\fR:VALUE]
unset variable KEY or set to VALUE
.PP
Sheets:
.TP
\fB\-M\fR, \fB\-\-medium\fR=\fI\,NAME\/\fR
use output medium NAME
.TP
\fB\-r\fR, \fB\-\-landscape\fR
print in landscape mode
.TP
\fB\-R\fR, \fB\-\-portrait\fR
print in portrait mode
.TP
\fB\-\-columns\fR=\fI\,NUM\/\fR
number of columns per sheet
.TP
\fB\-\-rows\fR=\fI\,NUM\/\fR
number of rows per sheet
.TP
\fB\-\-major\fR=\fI\,DIRECTION\/\fR
first fill (DIRECTION=) rows, or columns
.TP
\fB\-1\fR, \fB\-2\fR, ..., \fB\-9\fR
predefined font sizes and layouts for 1..9
virtuals
.TP
\fB\-A\fR, \fB\-\-file\-align\fR=\fI\,MODE\/\fR
align separate files according to MODE (fill,
rank page, sheet, or a number)
.TP
\fB\-j\fR, \fB\-\-borders\fR*
print borders around columns
.TP
\fB\-\-margin\fR[=\fI\,NUM\/\fR]
define an interior margin of size NUM
.PP
The options \fB\-1\fR.. \fB\-9\fR affect several primitive parameters to set up predefined
layouts with 80 columns.  Therefore the order matters: `\-R \fB\-f40\fR \fB\-2\fR' is
equivalent to `\-2'.  To modify the layout, use `\-2Rf40', or compose primitive
options (`\-\-columns', `\-\-font\-size' etc.).
.PP
Virtual pages:
.TP
\fB\-\-line\-numbers\fR=\fI\,NUM\/\fR
precede each NUM lines with its line number
.TP
\fB\-C\fR
alias for \fB\-\-line\-numbers\fR=\fI\,5\/\fR
.TP
\fB\-f\fR, \fB\-\-font\-size\fR=\fI\,SIZE\/\fR
use font SIZE (float) for the body text
.TP
\fB\-L\fR, \fB\-\-lines\-per\-page\fR=\fI\,NUM\/\fR
scale the font to print NUM lines per virtual
.TP
\fB\-l\fR, \fB\-\-chars\-per\-line\fR=\fI\,NUM\/\fR
scale the font to print NUM columns per virtual
.TP
\fB\-m\fR, \fB\-\-catman\fR
process FILE as a man page (same as \fB\-L66\fR)
.TP
\fB\-T\fR, \fB\-\-tabsize\fR=\fI\,NUM\/\fR
set tabulator size to NUM
.HP
\fB\-\-non\-printable\-format\fR=\fI\,FMT\/\fR specify how non\-printable chars are printed
.PP
Headings:
.TP
\fB\-B\fR, \fB\-\-no\-header\fR
no page headers at all
.TP
\fB\-b\fR, \fB\-\-header\fR[=\fI\,TEXT\/\fR]
set page header
.TP
\fB\-u\fR, \fB\-\-underlay\fR[=\fI\,TEXT\/\fR]
print TEXT under every page
.TP
\fB\-\-center\-title\fR[=\fI\,TEXT\/\fR]
set page title to TITLE
.TP
\fB\-\-left\-title\fR[=\fI\,TEXT\/\fR]
set left and right page title to TEXT
.HP
\fB\-\-right\-title\fR[=\fI\,TEXT\/\fR]
.TP
\fB\-\-left\-footer\fR[=\fI\,TEXT\/\fR]
set sheet footers to TEXT
.HP
\fB\-\-footer\fR[=\fI\,TEXT\/\fR]
.HP
\fB\-\-right\-footer\fR[=\fI\,TEXT\/\fR]
.PP
The TEXTs may use special escapes.
.PP
Input:
.TP
\fB\-a\fR, \fB\-\-pages\fR[=\fI\,RANGE\/\fR]
select the pages to print
.TP
\fB\-c\fR, \fB\-\-truncate\-lines\fR*
cut long lines
.TP
\fB\-i\fR, \fB\-\-interpret\fR*
interpret tab, bs and ff chars
.TP
\fB\-\-end\-of\-line\fR=\fI\,TYPE\/\fR
specify the eol char (TYPE: r, n, nr, rn, any)
.TP
\fB\-X\fR, \fB\-\-encoding\fR=\fI\,NAME\/\fR
use input encoding NAME
.TP
\fB\-t\fR, \fB\-\-title\fR=\fI\,NAME\/\fR
set the name of the job
.TP
\fB\-\-stdin\fR=\fI\,NAME\/\fR
set the name of the input file stdin
.TP
\fB\-\-print\-anyway\fR*
force binary printing
.TP
\fB\-Z\fR, \fB\-\-delegate\fR*
delegate files to another application
.TP
\fB\-\-toc\fR[=\fI\,TEXT\/\fR]
generate a table of content
.PP
When delegations are enabled, a2ps may use other applications to handle the
processing of files that should not be printed as raw information, e.g., HTML
PostScript, PDF etc.
.PP
Pretty\-printing:
.TP
\fB\-E\fR, \fB\-\-pretty\-print\fR[=\fI\,LANG\/\fR]
enable pretty\-printing (set style to LANG)
.TP
\fB\-\-highlight\-level\fR=\fI\,LEVEL\/\fR
set pretty printing highlight LEVEL
LEVEL can be none, normal or heavy
.TP
\fB\-g\fR
alias for \fB\-\-highlight\-level\fR=\fI\,heavy\/\fR
.TP
\fB\-\-strip\-level\fR=\fI\,NUM\/\fR
level of comments stripping
.PP
Output:
.TP
\fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR
leave output to file FILE.  If FILE is `\-',
leave output to stdout.
.TP
\fB\-\-version\-control\fR=\fI\,WORD\/\fR
override the usual version control
.TP
\fB\-\-suffix\fR=\fI\,SUFFIX\/\fR
override the usual backup suffix
.TP
\fB\-P\fR, \fB\-\-printer\fR=\fI\,NAME\/\fR
send output to printer NAME
.TP
\fB\-d\fR
send output to the default printer
(this is the default behavior)
.PP
PostScript:
.TP
\fB\-\-prologue\fR=\fI\,FILE\/\fR
include FILE.pro as PostScript prologue
.TP
\fB\-\-ppd\fR[=\fI\,KEY\/\fR]
automatic PPD selection or set to KEY
.TP
\fB\-n\fR, \fB\-\-copies\fR=\fI\,NUM\/\fR
print NUM copies of each page
.TP
\fB\-s\fR, \fB\-\-sides\fR=\fI\,MODE\/\fR
set the duplex MODE (`1' or `simplex',
`2' or `duplex', `tumble')
.TP
\fB\-S\fR, \fB\-\-setpagedevice\fR=\fI\,K[\/\fR:V]
pass a page device definition to output
.TP
\fB\-\-statusdict\fR=\fI\,K[\/\fR:[:]V]
pass a statusdict definition to the output
.TP
\fB\-k\fR, \fB\-\-page\-prefeed\fR
enable page prefeed
.TP
\fB\-K\fR, \fB\-\-no\-page\-prefeed\fR
disable page prefeed
.PP
By default a2ps is tuned to do what you want to, so trust it.  To pretty print
the content of the `src' directory and a table of content, and send the result
to the printer `lw',
.IP
\f(CW$ a2ps -P lw --toc src/*\fR
.PP
To process the files `sample.ps' and `sample.html' and display the result,
.IP
\f(CW$ a2ps -P display sample.ps sample.html\fR
.PP
To process a mailbox in 4 up,
.IP
\f(CW$ a2ps -=mail -4 mailbox\fR
.PP
To print as a booklet on the default printer, which is duplex capable,
.IP
\f(CW$ a2ps -=book paper.dvi.gz -d\fR
.SH FILES
a2ps reads several files before the command line options.  In order,
they are:

.IP 1.
The system configuration file (usually \fI/usr/local/etc/a2ps.cfg\fR)
unless you have defined the environment variable \fIA2PS_CONFIG\fR, in
which case a2ps reads the file it points to;

.IP 2.
the user's home configuration file (\fI$HOME/.a2ps/a2psrc\fR)

.IP 3.
the file \fI.a2psrc\fR in the current directory.

See the info manual for more information, including a description of the
configuration file format.
.SH AUTHOR
Written by Akim Demaille, Miguel Santana, and Reuben Thomas.
.SH "REPORTING BUGS"
Report bugs to: bug\-a2ps@gnu.org
.br
GNU a2ps home page: <https://www.gnu.org/software/a2ps/>
.br
General help using GNU software: <https://www.gnu.org/gethelp/>
.SH COPYRIGHT
Copyright \(co 2023 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
.BR a2ps (1),
.BR card (1),
.BR fixps (1),
.BR pdiff (1).
.PP
The full documentation for
.B a2ps
is maintained as a Texinfo manual.  If the
.B info
and
.B a2ps
programs are properly installed at your site, the command
.IP
.B info a2ps
.PP
should give you access to the complete manual.