This little package will enable users to generate barcodes from within
Lout. The barcode font is a 3 of 9 font developed by Willem van
Schaik. There are two versions of the package. The first version was
developed for Lout 3.04 and will also work successfully for versions
upto and including 3.06. The second version is for Lout 3.07 and
above. It has been successfully tested with Lout 3.08.

See the Makefile for installation options depending on which version
of Lout you are using.

If you don't have make then see the files 3.06/README or 3.07/README
for installation instructions.

MODIFICATION BY JEFF KINGSTON
-----------------------------

I do not maintain this package but I have modified it slightly to
adapt it to the way fonts are defined in recent versions of Lout,
via a @FontDef database entry (which I have added to standard.ld
in the main Lout distribution) rather than a fontdef line.

Jeff Kingston
18 September 2001


COPYRIGHT AND SUCH
------------------
I make NO claims on the copyright to the PostScript code developed by
Willem van Schaik. As Willem posted the code to a Usenet newsgroup,
I'm taking that as tacit approval that the code is in the public
domain. Any further copyright issues regarding the PostScript
definition can be taken up with Willem (gwillem@alpha.ntu.ac.sg).

The Makefile is based on the Makefile distributed with the
lout.russian.1.0 package.

The rest of the files in this package can be considered to be placed
in the public domain. Feel free to modify or redistribute them in any
way, shape or form your heart desires.

Taking a leaf out of Jeff Kingston's book (the next three paragrpahs
have been copied verbatim from the README file distributed with the
lout.russian.1.0 package):

    This program is free software; you can redistribute it and/or
    modify it under the terms of the GNU General Public License as
    published by the Free Software Foundation; either version 1, or (at
    your option) any later version.

    This program is distributed in the hope that it will be useful, but
    WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
    General Public License for more details.

    You should have received a copy of the GNU General Public License
    (file gnu.gpl in this directory); if not, write to the Free
    Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

SUPPORTED CHARACTERS
--------------------

The Code39 font only supports a limited number of characters. The
following table lists these characters.

    space $ % * + - . /
    0 1 2 3 4 5 6 7 8 9 =
    A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

All other characters are not defined so will produce NULL results if
included in a lout document.

USAGE
-----

If you want to use the barcode font in your Lout documents, simply add
the following line to the list of system include files at the
beginning of the document:

    @SysInclude { barcodes }

Then to use the font, simply use the @Font command as follows

    {BarCode Base} @Font {0123456789ABC}

Have a close look at the example file for more details.


Peter Samuel - peter@uniq.com.au
Wed May 15 19:06:16 EST 1996
