libcaca/README

$Id$

Building libcaca

   o  Run configure then make. Useful configure flags are:

     --enable-ncurses: support for the ncurses library
     --enable-slang: support for the SLang library
     --enable-conio: support for MS-DOS conio.h
     --enable-x11: support for native X11 rendering

     --disable-imlib2: remove Imlib2 support in cacaview

   o  Cross-compilation examples:
 
     ./configure --disable-imlib2 --host=i386-pc-msdosdjgpp

     ./configure --disable-imlib2 --host=i586-mingw32msvc


Using libcaca

   o  Look into the examples/ directory for simple source code examples.

   o  Compiling a libcaca program is fairly simple:

      gcc -c foobar.c -o foobar.o `caca-config --cflags`
      gcc foobar.o -o foobar `caca-config --libs`

   o  If you are writing a shared object that uses libcaca, either a
      dynamically loadable plug-in or a shared library, you should use
      the `--plugin-libs' flag for libcaca:

      gcc -fPIC -c libfoo.c -o libfoo.o `caca-config --cflags`
      gcc -shared libfoo.o -o libfoo.so `caca-config --plugin-libs`


Binary packages

   o  As the API is not stable yet, everyone should statically link libcaca
      with their programs or libraries. DO NOT DISTRIBUTE SHARED VERSIONS
      OF LIBCACA.