Read Me

* ABOUT

a2png is a program that converts text into bitmap images such as PNG.


* REQUIREMENTS

You need one of the following graphics libraries:

	- gdlib, http://www.boutell.com/gd/            (default)
	- cairo graphics, http://www.cairographics.org (recommended)


* QUICK HOW-TO BUILD

	./configure
	make check
	make install

This will try to configure for building with the gd library (version 2).


* MORE INFORMATION ON BUILDING A2PNG

If you want to use Cairo Graphics intead of the GD library, you have to
specify where the cairo include files are located.  If you know they are
installed in `/opt/local/include/cairo/cairo.h' then do this:

	./configure --with-cairo-prefix=/opt/local/
	make check
	make install

If the include and lib files are not located under the same
root directory, then you can explicitly specify them:

	./configure --with-cairo-include=/opt/local/include/cairo/ \
	            --with-cairo-lib=/opt/local/lib/
	make check
	make install


* BUILDING ON MAC OS X

If you don't have cairo installed, you can do this:

	sudo port install cairo
	./configure --with-cairo-prefix=/opt/local/
	make check
	make install


COPYRIGHT
a2png is Copyright (C) 2006 Christian Stigen Larsen <csl@sublevel3.org>
http://csl.sublevel3.org

Distributed under the GNU General Public License (GPL) v2.
For more information on GPL, see http://www.gnu.org/copyleft/


$Id$