SEARCH
NEW RPMS
DIRECTORIES
ABOUT
FAQ
VARIOUS
BLOG
DONATE


YUM REPOSITORY

 
 

MAN page from StartCom 5 a2ps-4.13b-57.2.SEL5_4.i386.rpm

A2PS

Section: FSF (1)
Updated: February 2000
Index 

NAME

a2ps - format files for printing on a PostScript printer 

SYNOPSIS

a2ps[OPTION]... [FILE]... 

DESCRIPTION

Convert FILE(s) or standard input to PostScript.

Mandatory arguments to long options are mandatory for short options too.Long options marked with * require a yes/no argument, correspondingshort options stand for `yes'. 

Tasks:

--version
display version
--help
display this help
--guess
report guessed types of FILES
--which
report the full path of library files named FILES
--glob
report the full path of library files matching FILES
--list=defaults
display default settings and parameters
--list=TOPIC
detailed list on TOPIC (delegations, encodings, features,variables, media, ppd, printers, prologues, style-sheets,user-options)

After having performed the task, exit successfully. Detailed lists mayprovide additional help on specific features. 

Global:

-q, --quiet, --silent
be really quiet
-v, --verbose[=LEVEL]
set verbosity on, or to LEVEL
-=, --user-option=OPTION
use the user defined shortcut OPTION
--debug
enable debugging features
-D, --define=KEY[:VALUE]
unset variable KEY or set to VALUE
 

Sheets:

-M, --medium=NAME
use output medium NAME

The default behaviour is to use the locale categoryLC_PAPER to determine the medium to use. Note that thisinformation is obtained from environment variables which may not be setup in non-interactive environments (such as in a cron job).

-r, --landscape
print in landscape mode
-R, --portrait
print in portrait mode
--columns=NUM
number of columns per sheet
--rows=NUM
number of rows per sheet
--major=DIRECTION
first fill (DIRECTION=) rows, or columns
-1, -2, ..., -9
predefined font sizes and layouts for 1.. 9 virtuals
-A, --file-align=MODE
align separate files according to MODE (fill, rankpage, sheet, or a number)
-j, --borders*
print borders around columns
--margin[=NUM]
define an interior margin of size NUM

The options -1.. -9 affect several primitive parameters to set up predefinedlayouts with 80 columns. Therefore the order matters: `-R -f40 -2' isequivalent to `-2'. To modify the layout, use `-2Rf40', or compose primitiveoptions (`--columns', `--font-size' etc.). 

Virtual pages:

--line-numbers=NUM
precede each NUM lines with its line number
-C
alias for --line-numbers=5
-f, --font-size=SIZE
use font SIZE (float) for the body text
-L, --lines-per-page=NUM
scale the font to print NUM lines per virtual
-l, --chars-per-line=NUM
scale the font to print NUM columns per virtual
-m, --catman
process FILE as a man page (same as -L66)
-T, --tabsize=NUM
set tabulator size to NUM
--non-printable-format=FMT specify how non-printable chars are printed
 

Headings:

-B, --no-header
no page headers at all
-b, --header[=TEXT]
set page header
-u, --underlay[=TEXT]
print TEXT under every page
--center-title[=TEXT]
set page title to TITLE
--left-title[=TEXT]
set left and right page title to TEXT
--right-title[=TEXT]
--left-footer[=TEXT]
set sheet footers to TEXT
--footer[=TEXT]
--right-footer[=TEXT]

The TEXTs may use special escapes. 

Input:

-a, --pages[=RANGE]
select the pages to print
-c, --truncate-lines*
cut long lines
-i, --interpret*
interpret tab, bs and ff chars
--end-of-line=TYPE
specify the eol char (TYPE: r, n, nr, rn, any)
-X, --encoding=NAME
use input encoding NAME
-t, --title=NAME
set the name of the job
--stdin=NAME
set the name of the input file stdin
--print-anyway*
force binary printing
-Z, --delegate*
delegate files to another application
--toc[=TEXT]
generate a table of content

When delegations are enabled, a2ps may use other applications to handle theprocessing of files that should not be printed as raw information, e.g., HTMLPostScript, PDF etc. 

Pretty-printing:

-E, --pretty-print[=LANG]
enable pretty-printing (set style to LANG)
--highlight-level=LEVEL
set pretty printing highlight LEVELLEVEL can be none, normal or heavy
-g
alias for --highlight-level=heavy
--strip-level=NUM
level of comments stripping
 

Output:

-o, --output=FILE
leave output to file FILE. If FILE is `-',leave output to stdout.
--version-control=WORD
override the usual version control
--suffix=SUFFIX
override the usual backup suffix
-P, --printer=NAME
send output to printer NAME
-d
send output to the default printer
 

PostScript:

--prologue=FILE
include FILE.pro as PostScript prologue
--ppd[=KEY]
automatic PPD selection or set to KEY
-n, --copies=NUM
print NUM copies of each page
-s, --sides=MODE
set the duplex MODE (`1' or `simplex',`2' or `duplex', `tumble')
-S, --setpagedevice=K[:V]
pass a page device definition to output
--statusdict=K[:[:]V]
pass a statusdict definition to the output
-k, --page-prefeed
enable page prefeed
-K, --no-page-prefeed
disable page prefeed

By default a2ps is tuned to do what you want to, so trust it. To prettyprint the content of the `src' directory and a table of content, and send theresult to the printer `lw',

$ a2ps -P lw --toc src/*

To process the files `sample.ps' and `sample.html' and display the result,

$ a2ps -P display sample.ps sample.html

To process a mailbox in 4 up,

$ a2ps -=mail -4 mailbox

To print as a booklet on the default printer, which is Duplex capable,

$ a2ps -=book paper.dvi.gz -d

News, updates and documentation: visit http://www.inf.enst.fr/~demaille/a2ps/. 

AUTHOR

Written by Akim Demaille, Miguel Santana. 

REPORTING BUGS

Report bugs to <bug-a2psAATTgnu.org>. 

COPYRIGHT

Copyright © 1988-1993 Miguel Santana
Copyright © 1995-2000 Akim Demaille, Miguel Santana
This is free software; see the source for copying conditions. There is NOwarranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 

SEE ALSO

a2ps(1),card(1),fixps(1),pdiff(1),psset(1),texi2dvi4a2ps(1).

The full documentation fora2psis maintained as a Texinfo manual. If theinfoanda2psprograms are properly installed at your site, the command

info a2ps

should give you access to the complete manual.


 

Index

NAME
SYNOPSIS
DESCRIPTION
Tasks:
Global:
Sheets:
Virtual pages:
Headings:
Input:
Pretty-printing:
Output:
PostScript:
AUTHOR
REPORTING BUGS
COPYRIGHT
SEE ALSO

This document was created byman2html,using the manual pages.