* AUTHORS NEWS:

+ Added these mandatory files.
  * doc/:
    + Wrote a Doxygen configuration file.
    + Added a manpage for caca-config(1), borrowed from sdl-config.
  * configure.ac:
    + Use new style AC_INIT.
    + Error out if no library was found.
    + Added *djgpp* to the list of non-PIC platforms.
    + Added checks for doxygen and latex.

AUTHORS

@@ -0,0 +1,3 @@
+$Id$
+
+Sam Hocevar <sam@zoy.org>

Makefile.am

@@ -2,11 +2,11 @@
 # Automake targets and declarations for libcaca
 ###############################################################################
 
-SUBDIRS = src examples
+SUBDIRS = src examples doc
 DIST_SUBDIRS = $(SUBDIRS) autotools debian
 
 EXTRA_DIST = BUGS bootstrap caca-config.in
-AUTOMAKE_OPTIONS = foreign dist-bzip2
+AUTOMAKE_OPTIONS = dist-bzip2
 
 bin_SCRIPTS = caca-config
 

NEWS

@@ -0,0 +1,10 @@
+$Id$
+
+New in v0.1
+-----------
+
+  * initial release
+  * slang, ncurses and conio drivers
+  * basic line, box, ellipse and triangle primitives
+  * colour bitmap blitting
+

configure.ac

@@ -1,13 +1,12 @@
 # $Id$
 
-AC_INIT(libcaca,0.0cvs-20031110)
+AC_INIT(src/caca.c)
 
 AC_PREREQ(2.50)
-AC_CONFIG_SRCDIR(src/caca.c)
 AC_CONFIG_AUX_DIR(autotools)
 AC_CANONICAL_SYSTEM
 
-AM_INIT_AUTOMAKE(libcaca,0.0cvs-20031110)
+AM_INIT_AUTOMAKE(libcaca, 0.1)
 AM_CONFIG_HEADER(config.h)
 
 AM_PROG_CC_C_O
@@ -48,6 +47,8 @@ elif test "${enable_slang}" != "no"; then
   AC_CHECK_LIB(slang,SLkp_init,:,AC_MSG_ERROR([cannot find slang library]))
   AC_DEFINE(USE_SLANG, 1, Define if the backend driver is slang)
   USE_SLANG=:
+else
+  AC_MSG_ERROR([could not find any terminal graphics interface])
 fi
 
 AM_CONDITIONAL(USE_SLANG, ${USE_SLANG})
@@ -60,20 +61,33 @@ CFLAGS="${CFLAGS} -Wall -Wpointer-arith -Wcast-align -Wcast-qual -Wstrict-protot
 
 # Build the PIC library?
 case "${target_os}" in
-  *mingw32* | *cygwin*)
+  *mingw32* | *cygwin* | *djgpp*)
     NEED_PIC=false
     ;;
   *)
     NEED_PIC=:
     ;;
 esac
-
 AM_CONDITIONAL(NEED_PIC, ${NEED_PIC})
 
+# Build documentation?
+AC_PATH_PROG(DOXYGEN, doxygen, no)
+AM_CONDITIONAL(DOXYGEN, test "${DOXYGEN}" != "no")
+AC_PATH_PROG(LATEX, latex, no)
+AC_MSG_CHECKING(for a4wide.sty)
+if test -f /usr/share/texmf/tex/latex/misc/a4wide.sty; then
+  AC_MSG_RESULT(yes)
+else
+  LATEX=no
+  AC_MSG_RESULT(no)
+fi
+AM_CONDITIONAL(LATEX, test "${LATEX}" != "no")
+
 AC_OUTPUT([
   Makefile
   src/Makefile
   examples/Makefile
+  doc/Makefile
   autotools/Makefile
   debian/Makefile
   caca-config

doc/Makefile.am

@@ -0,0 +1,25 @@
+EXTRA_DIST = doxygen.cfg footer.html header.html $(man_MANS)
+
+man_MANS = caca-config.1
+
+all: stamp-doxygen stamp-latex
+
+stamp-doxygen:
+if DOXYGEN
+	doxygen doxygen.cfg
+	touch stamp-doxygen
+endif
+
+stamp-latex: stamp-doxygen
+if DOXYGEN
+if LATEX
+	cd latex && $(MAKE) $(AM_CFLAGS) ps
+	touch stamp-latex
+endif
+endif
+
+clean: clean-local
+clean-local:
+	-rm -Rf html latex
+	-rm -f stamp-latex stamp-doxygen
+

doc/caca-config.1

@@ -0,0 +1,73 @@
+.TH caca-config 1 "2003-11-22" "SDL 1.2"
+.SH NAME
+caca-config \- script to get information about the installed version of libcaca
+.SH SYNOPSIS
+.B caca-config
+[ --prefix=
+.IR DIR ]
+[ --exec-prefix=
+.IR DIR ]
+[ --version ] [ --libs | --plugin-libs ] [ --cflags ]
+.SH DESCRIPTION
+.B caca-config
+is a tool that is used to configure and determine the compiler and linker
+flags that should be used to compile and link progams, libraries, and
+plugins that use libcaca.
+.SH OPTIONS
+.TP
+.B --cflags
+Print the compiler flags that are necessary to compile a program or library
+that uses libcaca.
+.TP
+.BI --exec-prefix= DIR
+If specified, use
+.I DIR
+instead of the installation exec prefix that libcaca was build with when
+computing the output for the --cflags, --libs, and --plugin-libs options.
+This option must be specified before any of the --cflags, --libs, and
+--plugin-libs options.
+.TP
+.B --libs
+Print the linker flags that are necessary to link a program that uses
+libcaca.
+.TP
+.B --plugin-libs
+Print the linker flags that are necessary to link a libcaca-using object that
+is to be accessed via
+.IR dlopen (3).
+This may include static objects with PIC symbol information.  This option
+should
+.B not
+be used for standalone applications.
+.TP
+.BI --prefix= DIR
+If specified, use PREFIX instead of the installation prefix that libcaca
+was built with when computing the output for the --cflags, --libs,
+and --plugin-libs options.  This option is also used for the exec prefix
+if --exec-prefix was not specified.  This option must be specified before
+any of the --cflags, --libs, and --plugin-libs options.
+.TP
+.B --version
+Prints the currently installed version of libcaca on standard output.
+.SH EXAMPLES
+.TP
+gcc -o main.o $(caca-config --cflags) -c main.c
+is how you might use
+.B caca-config
+to compile a C source file for an executable program.
+.TP
+gcc -o my_app $(caca-config --libs) main.o util.o
+is how you might use
+.B caca-config
+to link compiled objects into an executable program.
+.TP
+gcc -o libcaca_plugin.so $(caca-config --plugin-libs) caca_plugin.o stubs.o
+is how you might use
+.B caca-config
+to link compiled objects into a plugin for use by another program.
+.SH AUTHOR
+The libcaca library was written by Sam Hocevar <sam@zoy.org>.
+.PP
+This manual page was written for sdl-config by Branden Robinson, originally
+for Progeny Linux Systems, Inc., and the Debian Project. It was adapted to
+libcaca by Sam Hocevar.

doc/footer.html

@@ -0,0 +1,3 @@
+<!-- $Id$ -->
+  </body>
+</html>

doc/header.html

@@ -0,0 +1,9 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+  <head>
+    <meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
+    <title>libcaca documentation</title>
+    <link href="doxygen.css" rel="stylesheet" type="text/css">
+  </head>
+  <body>
+<!-- $Id$ -->