Win32 (Pre-Compiled Distribution)
=================================

Copy yydecode.exe to somewhere in your PATH, eg. C:\Windows\Command .
Alternatively, create a shortcut to it on your desktop, and drop any
files you wish to decode on it. You can enter at the command prompt:

    C:\> yydecode --help

for a brief help summary, while README.txt contains the gory details. If
you run yydecode with no switches or files on the command line, it will
sit there waiting for data from the keyboard -- this is almost certainly
not what you had wanted!

Drop me a note if there are any problems -- I don't (read: can't!)
always test to see if the cross-compiled executable works (at all!)


Compiling from Source
=====================

You can always find the latest stable source code for yydecode on the
website hosted at SourceForge: http://yydecode.sf.net/ . Development
(usually usable) and previous versions can be downloaded from my own
server, at http://nerv.cx/liyang/download/ .

After unpacking the tarball, simply:

    $ ./configure --prefix=/usr/local
    $ make
    $ make check

as a mortal user, then:

    # make install

as the root user will put yydecode into /usr/local/bin, the manual pages
into /usr/local/man and so on. Run:

    $ ./configure --help

if you would like help on customising any aspect of the compilation and
/ or installation process.


Compilation Notes
=================

yydecode has been verified to compile successfully on the following
platforms: (This list is woefully out of date.)

 * [gcc] Debian GNU/Linux 3.0 (Woody) on Intel x86 (and compatibles)
 * [gcc] Debian GNU/Linux 2.2 (Potato) on Intel x86 (SMP)
 * [gcc] FreeBSD 4.4-STABLE on Intel x86
 * [gcc] Debian GNU/Linux 2.2 (Potato) on DEC Alpha
 * [gcc] Debian GNU/Linux 2.2 (Potato) on PowerPC RS/6000
 * [gcc] Debian GNU/Linux 2.2 (Potato) on Sparc (Ultra60)
 * [gcc] Sun Solaris (SunOS 5.8) on Sparc (R220)
 * [cc] Darwin Kernel 5.2 (Mac OS X Server 10.1) on Apple G4
 * [cygwin] Win32, using CygWin
 * [mingw32] Cross-compile for Win32, from Debian GNU/Linux 3.0

Reports of successful compiles on any other esoteric (in your opinion)
platforms / architectures, or corrections to the above, would be most
welcome. See AUTHORS for email details.

(Note that where it says Debian GNU/Linux, you can almost certainly sub-
stitute in any other recent Linux distribution.)

# End of File # vim: tw=72:

