A4UP - an Amiga DeskJet/LaserJet Utility

                version 1.3 copyright G Chiu 1 March 1992

This is the second release of A4UP, and represents an Intuitionised version
version of ADJ4UP released to a couple of BBSs in 1990.

It is intended for use with the HP LaserJet ( and clones ), and the DeskJet
series.  The latter needs added memory to accept the custom font.  It prints
to A4 and letter paper.  I don't have access to American letter paper but
guess it that it should be OK, though the page length may need reducing, and
it might not be centred on the page. The only other requirement is for good
eyesight to read the printed output.

A4UP uses the Nico Francois' reqtools.library which is included and must be
placed into your libs: directory.

A4UP prints a text file to A4/letter paper in portrait mode using two columns
of either 80 or 85 columns wide and a maximum of 120 lines per physical page.
This is 4 pages of text of 80 or 85 columns by 60 lines of logical page, and
uses Hexagon Product's shareware and proprietary tiny font of point size 3.8
and pitch of 21.4 allowing 171 characters per line on an 8½ inch page.

The Intuition version contains documentation called from the HELP gadget,
and when run from the CLI will bring up the CLI help with the "-?" flag.
Note that the default printer from the Intuition version is the LaserJet,
and from the CLI is the DeskJet.

Some more explanation follows regarding CLI usage:

    A4UP -oram:out myfile

    prints 'myfile' to the file ram:out

    A4UP -w myfile

    prints 'myfile' to the default port par: using 85 columns

    A4UP -w widefile -w thinfile

    prints widefile to the default port par: using 85 columns and then prints
    thinfile to par: using 80 columns ( the second -w toggles the column width
    back to 80 )

    NB: At each invocation the font is downloaded to the printer only with
    the first file being printed and any other files following in the command
    line being printed assume the font is present.  So, don't print first
    to a file and then to the printer and expect it to work!

Workbench usage is slightly crippled in that it does a rather system
unfriendly busy wait which ties up the CPU.  This is fixed in the registered
version ( see HELP gadget for details ) which adds extended file selection
to allow a number of files to be printed at one hit.  When used as a CLI
utility this limitation is not present.

I don't have any working tools ( except those running under KS 1.1 ) which
monitor memory allocation/deallocation, or check for low memory being trampled
on etc., so please send bug reports to:

    G Chiu, 5 Kate Way, Karori, Wellington, New Zealand

    or G.CHIU2 on GEnie

Bugs: Quite a few changes since v1.1, so ...
      Intermittently locks up on me, don't know why :-(

A4UP is not to be released onto any disk collection without the written
permission of the author ( which will usually be granted ).

Updates:

v1.1

23 Feb 1992 - forgot to call purgefiles on the filerequester
            - added an abort requester for CLI operation
            - added pause flag -h for CLI operation
            - added extended file selection ( for registered version )

v1.2

24 Feb 1992 - req.library wouldn't open in the CLI version, fixed
            - if 85 columns on A4 paper with LaserJet, last 2 columns
              truncated ( never did this on my old DeskJet ), so
              added support for Letter paper which allows printing of the
              last two columns on A4 paper

v1.3

 7 Mar 1992 - changed over to reqtools.library which offers a pattern
              select in the file requester, and as using the req.library
              extended file selection would intermittently guru on me
              ( of course it probably wasn't a req.library fault at all )
            - tossed in an iconize function with the rmb
            - running as a crunched file gurus at odd times, therefore
              released as a normal file.

Hmm. I don't think anyone is using this program. Not a single bug report
received yet!