Description
===========

GNU a2ps is an Any to PostScript filter.  Of course it processes plain
text files, but also pretty prints quite a few popular languages.

Its slogan is precisely "Do The Right Thing", which means that
though it is highly configurable, everything was made so that a novice
user can do complicated PostScript manipulations.  For instance, it
has the ability to delegate the processing of some files to other
filters (such as groff, texi2dvi, dvips, gzip etc.), what allows a
uniform treatment (n-up, page selection, duplex etc.) of heterogeneous
files.

As an example:

| $ a2ps mill.1.ps.gz a2ps.gif NEWS a2ps.texi index.html -o demo.ps
| [mill.1.ps.gz (compressed, delegated to Gzip-a2ps): 17 pages on 9 sheets]
| [a2ps.gif (gif, delegated to ImageMagick): 3 pages on 2 sheets]
| [NEWS (plain): 12 pages on 6 sheets]
| [a2ps.texi (texinfo, delegated to texi2dvi): 89 pages on 45 sheets]
| [index.html (html, delegated to Netscape): 13 pages on 7 sheets]
| [Total: 132 pages on 66 sheets] saved into the file `demo.ps'

Want to print a LaTeX file in Duplex?

| $ a2ps paper.tex -s2 -P margot
| [paper.tex (tex, delegated to texi2dvi): 33 pages on 9 sheets]
| request id is margot-129 (standard input)
| [Total: 34 pages on 9 sheets] sent to the printer `margot'

(Bibtex, makeindex, and latex were run as many times as needed.)

Or maybe you want to print the documentation as a booklet?

| $ a2ps -P margot -=book doc/a2ps.texi
| [doc/a2ps.texi (texinfo, delegated to texi2dvi): 109 pages on 109 sheets]
| request id is margot-128 (standard input)
| [Total: 109 pages on 109 sheets] sent to the printer `margot'

It supports a wide number of encodings, and a very good handling of
Latin 2-6 should be noted, thanks to Ogonkify (by Juliusz Chroboczek
<jec@dcs.ed.ac.uk>).  Needed fonts are automatically downloaded.  The
interface is internationalized, the output is customizable and there
are as many options as users had wishes (table of content, headings,
virtual page layout etc. etc.).

The documentation has been carefully crafted for both novices and
experts.  It is meant to bring light on most questions you have, and
includes a glossary.

Contributions
=============

Some goodies are provided in the package:
 - card     pretty prints `--help' from programs
 - fixps    fixes most common problems in PostScript files
 - lp2      eases Duplex printing on Simplex printers
 - pdiff    prints a comparison between two files

The full distribution of Ogonkify, by Juliusz Chroboczek, is also
included.  Ogonkify let's you fix deficient Latin 2-6 support in
popular applications' PostScript (Netscape, StarOffice...).


Downloading
===========

GNU a2ps can be found on its web page:

	https://www.gnu.org/software/a2ps/

There is also a mailing list set up to discuss around a2ps.  To
subscribe, please see https://lists.gnu.org/mailman/listinfo/a2ps.
Contributions of any kind are most welcome!

Please do *not* use this address to report bugs, use
<bug-a2ps@gnu.org>.

Authors
=======

a2ps is written by akim@freefriends.org, Miguel.Santana@st.com and
mhatta@gnu.org.  We hope you'll enjoy it!

--
Akim, Miguel & Masayuki