File        : ReadMe
Date        : 19-Sep-02
Description : Help file for AlexLib.

Copyright  1995-2002 Alexander Thoukydides

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 2
of the License, 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
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA


INTRODUCTION

AlexLib is a library consisting of an eclectic collection of assembler, C and
C++ source code. It was original developed for personal use, but has now been
released under the GNU General Public License to enable a similar release of
other software that uses it.

The components of this library were developed over a long period of time, and
contain several experiments in software design, not all of which were
necessarily successful or completed. As such it should not be treated as an
example of elegant or efficient coding. New software should probably not use
this library.


TOOL VERSIONS

The following tools from the Acorn C/C++ suite were used to build this
version of AlexLib:

    amu
        Version 5.02

    cc
        Version 5.09

    c++
        Version 3.13

    cfront
        Version 3.0 (Acorn port 0.2)

    libfile
        Version 5.00

    squeeze
        Version 5.00

    objasm
        Version 3.06

The following additional tools were also used:

    drlink
        Version 0.34
        http://www.arcade.demon.co.uk/drlink.html

    perl
        Version 5.005 (RISC OS port 1.13)
        http://www.flirble.org/~nick/P/


LIBRARY VERSIONS

The following third party libraries, in addition to those supplied with Acorn
C/C++, were used to build this version of AlexLib:

    OSLib and OSLibSupport
        Version 6.32
        http://www.mk-net.demon.co.uk/oslib/

    CathLibCPP
        Issue 2
        http://www.accu.org/acornsig/public/cathlib/


CONTACTING THE AUTHOR

I would be interested in hearing of any bugs or other unexpected features in
this library, and will endeavour to correct any such problems in future
releases. However, this library is not being actively developed; suggestions
for new features or other improvements are not likely to be implemented.

If you have any comments on this library, I can be contacted at one of the
following addresses:

    Alexander Thoukydides
    6 Tenison Manor
    Cottenham
    Cambridge
    CB4 8XL

    alexlib@thouky.co.uk

If in any communication you make specific reference to the source code
please:

    Quote the version number and date of the library (it is stated at the
    bottom of this file).

    Refer only to the code as released.

    Supply as many details as possible about the problem, including the
    hardware and software configuration of the machine being used.

Please send a stamped and self addressed envelope, or give details of how to
contact via e-mail, if you would like a reply.

I hope you find this library of some use.


VERSION HISTORY

1.00 (04-Jun-00)    Released under version 2 of the GNU General Public License.

1.10 (19-Sep-02)    Updated to use OSLib version 6.32.