[PATCH] gtk-doc stuff

[Richard Hughes]

On Thu, 2007-03-08 at 13:33 -0500, William Jon McCann wrote:
> Hi,
> 
> Here's a patch to fix up some gtk-doc issues.
>  * It installs separate manuals for each of the libraries
>  * Adds GLIB_CFLAGS/LIBS so it builds
>  * Avoids scanning the hald directory (by using separate manuals)
>  * Adds some licence info to the manuals
>  * Adds an index to each manual
>  * Fixes up maintainer-clean

It breaks make distcheck (I think):

gtk-doc: Compiling scanner
mkdir .libs
 gcc -I/usr/include/glib-2.0 -I/usr/lib/glib-2.0/include
-I/usr/include/dbus-1.0 -I/usr/lib/dbus-1.0/include -I../../../..
-I../../.. -g -O2 -Wall -Wchar-subscripts -Wmissing-declarations
-Wnested-externs -Wpointer-arith -Wcast-align -Wsign-compare -c
libhal-scan.c  -fPIC -DPIC -o .libs/libhal-scan.o
 gcc -I/usr/include/glib-2.0 -I/usr/lib/glib-2.0/include
-I/usr/include/dbus-1.0 -I/usr/lib/dbus-1.0/include -I../../../..
-I../../.. -g -O2 -Wall -Wchar-subscripts -Wmissing-declarations
-Wnested-externs -Wpointer-arith -Wcast-align -Wsign-compare -c
libhal-scan.c -o libhal-scan.o >/dev/null 2>&1
gtk-doc: Linking scanner
gcc -g -O2 -Wall -Wchar-subscripts -Wmissing-declarations
-Wnested-externs -Wpointer-arith -Wcast-align -Wsign-compare
-Wl,--as-needed -o .libs/libhal-scan .libs/libhal-scan.o  -L/lib
-lgobject-2.0 -ldbus-glib-1 -lglib-2.0 ../../../libhal/.libs/libhal.so
-ldbus-1   -Wl,--rpath
-Wl,/home/hughsie/Code/hal/hal/hal-0.5.9/_inst/lib
creating libhal-scan
gtk-doc: Running scanner libhal-scan
Scan failed: 
make[5]: *** [scan-build.stamp] Error 255
make[5]: Leaving directory
`/home/hughsie/Code/hal/hal/hal-0.5.9/_build/doc/api/libhal'
make[4]: *** [all-recursive] Error 1

Although, it gets further than without your patch! :-)

Richard.