Imlib2-Ruby 0.4.2 README
========================

This document was last updated on Monday, October 28 21:51:36 2002 EST.
Please see the file COPYING for licensing and warranty information.  The
latest version of this library is available at the following URL:
http://www.pablotron.org/software/imlib2-ruby/.

Introduction
============
Imlib2-Ruby is a Ruby interface to Imlib2.  All of Imlib2 (except for
X11 calls) has been wrapped.  I've provided a my test script and handful
of commented scripts in examples/, and there's an rdoc-generated API
reference in doc/ (which you can rebuild yourself by typing "rdoc
./imlib2.c").  Imlib2-Ruby is also available in the FreeBSD ports
collection (courtesy of Akinori Musha), and Debian packages are
available on Jon Bernard's download page at
http://cs.roanoke.edu/~jbernard/downloads.html or via apt (see the
Related Links section below for the appropriate source line).
Imlib2-Ruby is still a work in progress, so bug reports or patches are
welcome.  Feel free to email me at the address below if you have any
additional questions.


System Requirements
===================
* Imlib2, version 1.0.5 (or newer):
  http://www.enlightenment.org/pages/imlib2.html
  (you can find source tarballs and RPMs at the following URL)
  ftp://ftp.sourceforge.net/pub/sourceforge/enlightenment/
* Ruby, version 1.6.x (or newer):
  http://www.ruby-lang.org/


Installation
============
ruby ./extconf.rb            # generate Makefile
make && su -c 'make install' # compile and install library


Related Links
=============
* RDoc: used to generate the API Documentation
  http://rdoc.sourceforge.net/
* Jon Bernard's Page: Imlib2-Ruby Debian packages
  http://cs.roanoke.edu/~jbernard/downloads.html
  Note:  You can also fetch Imlib2-Ruby via apt by adding the following
  line to your apt sources file:

    deb http://cs.roanoke.edu/~jbernard/downloads/ debian/


About the Author
================
Paul Duncan <pabs@pablotron.org>
http://www.pablotron.org/

See the file AUTHORS for additional contributions.
