Allegro-Perl v0.01 snapshot

  $Id$

  This is a set of Perl modules allowing access to the Allegro Low Level 
  Game Routines library.  It provides an object oriented interface to the 
  graphics, digital sound, timer, keyboard, joystick, and mouse routines 
  from Allegro.

  The official Allegro-Perl website is http://alperl.mx3.org.


WARNING

  This is not an "official" release of this module.  Things are still
  in development.  The API should not be considered stable;  method names
  and parameters are mostly set, but may change if needed.

  The module will likely be renamed to better fit into the CPAN naming
  scheme.  The only change needed will be to change the "use Allegro"
  line and Allegro->new call in user scripts when this happens.

  There are some memory leaks when Perl objects are destroyed and the
  underlying Allegro object isn't freed properly.  This only affects
  the Object Oriented interface.


INSTALLATION

  Source Installation:

    To install Allegro-Perl on a machine with a working compiler, complete
    Perl environment, and Allegro headers and library, enter the following
    after unpacking the Allegro-Perl archive:

      perl Makefile.PL
      make
      make test
      make install

    This will work on Linux and other Unix-like systems by using the 
    output of the "allegro-config" program which Allegro should 
    have installed with its "make install" target.  On Windows 
    "allegro-config" does not exist, so it may be necessary to edit 
    Makefile.PL to set the include and library paths if Allegro is not 
    installed in the default locations.

  Complete Windows Installation:

    Not yet.

  ActivePerl Installation:

    Not yet.  You'll need a MingW32 or Visual Studio installation
    to install right now.


DOCUMENTATION

  Documentation for each included module is available in POD format and
  is located in a .pod file corresponding to each .pm file.

  Use the "perldoc" program to access the documentation for each module or 
  visit the website for an HTML formatted reference.


COPYRIGHT AND LICENCE

  Copyright 2003 by Colin O'Leary.  All rights reserved.  This program
  is free software;  you can redistribute it and/or modify it under the 
  same terms as Perl itself.

  The Allegro library is copyright its authors, and is giftware.  See
  http://alleg.sf.net for more information.