*** Introduction ***

This is a pair of a2ps prologues (formatting style sheets) intended to
produce clean, readable output for the iRex iLiad ebook reader.

Since the iLiad has a good but not truly printer-quality resolution, it is
much easier to read sans-serif fonts on it than serif ones, but many
text-to-PDF programs default to serif fonts (especially Courier for
fixed-width printing).  Additionally, these prologues use grayscale instead
of full color, which can help save storage space.

These prologues require the availability of the Bera font family (a Type1
version of the Bitstream Vera fonts).  If you prefer to use another font
family, simply edit the .pro files to reflect the name of the other font(s).



*** Installing the Bera fonts ***

The Bera fonts may already be installed; if you're not sure, just try the
prologues and see if they work.

In order to make the changes described, you will need administrator (root)
privileges.  If you are not the system administrator, ask the administrator
to install the fonts for you.

Installing and setting up the fonts varies from system to system.  On
Gentoo, "emerge bera" installs the package. If your system does not have a
package for Bera, you can download it from
<http://www.ctan.org/tex-archive/fonts/bera/>.


Now you need to make the fonts available to a2ps.  Edit the /etc/a2ps.cfg
configuration file and add *both* the Bera AFM and Type1 directories to the
LibraryPath.  On Gentoo, the line looks like this:

"AppendLibraryPath: /usr/share/texmf/fonts/afm/public/bera:/usr/share/texmf/fonts/type1/public/bera"

Change the paths as appropriate for where your Bera fonts are installed.


Finally, go to the /usr/share/a2ps/afm directory and run "sh
make_fonts_map.sh".  This will re-scan all the listed font directories, and
your Bera directory should appear at the end.  Copy fonts.map.new to
fonts.map.



*** Installation ***

- Unpack the a2ps-iliad archive.

- Copy the .pro files to your ~/.a2ps directory.  (Create the directory if
  it doesn't exist.)

- If you already have an a2psrc file in your ~/.a2ps directory, append the
  line in the included a2psrc to it to add A6 support.  Otherwise, just copy
  the included file there.



*** Usage ***

In general, you can format text files (or source code, etc.) for your iLiad
simply by using the option "--prologue=iliad[-fixed]" to your a2ps command.
Other helpful options include:

-1	Don't print multiple pages per sheet.

-B	Don't print a header on every page.

-P pdf	Output to a PDF file (using ps2pdf).

-M A6	Format for A6-sized paper (the iLiad).

-l nn	Format for nn columns per page.  RFCs should use -l 73; most other
	fixed-width documents use -l 80.  The smaller the number of columns,
        the larger the print will be.
	
-L nn	Format for nn lines per page.  The smaller the number of rows, the
	larger the print will be.
	
--borders=off
	Don't draw a border around the page.
	
-t string
	Set the PostScript/PDF title for the document.


I have included two scripts which run a2ps with the appropriate prologue and
the following options: "-M A6 -1B --borders=off -P pdf".


Examples:

To print out an RFC:
$ a2ps --prologue=iliad-fixed -M A6 -1B --borders=off -P pdf -l 73 rfcXXXX.txt
- or-
$ a2ps-iliad-fixed -l 73 rfcXXXX.txt

To print out a Project Gutenberg etext:
$ a2ps --prologue=iliad -M A6 -1B --borders=off -P pdf -L 62 etext.txt
- or -
$ a2ps-iliad -L 62 etext.txt
