Re: glib & gtk-doc

[Patrick Welche <prlw1 newn cam ac uk>]

On Fri, May 30, 2003 at 05:50:30PM -0400, Owen Taylor wrote:
> On Thu, 2003-05-29 at 14:35, Patrick Welche wrote:
> > Given the excellent documentation on line, is it really necessary
> > to *require* gtk-doc to build glib from CVS? gtk-doc in turn requires
> > docbook, jade, libxslt, libxml (and perl). I really don't see why
> > I *have* to install docbook and jade just to build glib, would
> > making this optional be considered?
> > 
> > As far as I can see, a first step might be to conditionally run
> > gtkdocize in autogen.sh if it is found, and distributing gtk-doc.m4
> > (to keep configure.in happy with a m4_include(gtk-doc.m4) so that
> > --disable-gtk-doc exists) and gtk-doc.make (as it gets packaged up
> > in EXTRA_DIST) -- in fact, this just "worked for me".
> 
> Nobody is forcing you to build from CVS...
> 
> The idea of requiring gtkdocize is not to force the docs
> to be built but simply to get the build macros and makefile
> fragments that are needed to build GTK+.
> 
> You should be able to "fake it" by only installing gtkdocize,
> gtk-doc.make, and and gtk-doc.m4 from gtk-doc without the rest
> the package. May be more trouble than it's worth, however.

I just went through that cycle of
- remove the DIE=1 and || exit 1 in the gtkdocize parts of autogen.sh
- s/automake-1.4/automake/ or any other fixed number in autogen.sh
- touch gtk-doc.make
- cp ../gtk-doc/gtk-doc.m4 .
- add m4_include([gtk-doc.m4]) to configure.in
to the various directories of glib, gtk+, pango, atk and I it has all
compiled nicely (with the patch below as thai-x.c needs HAVE_X from
config.h, and removing AC_CYGWIN AC_EXEEXT from glib's configure.in
as this is taken care of by AC_PROG_CC)

> (Question for gtk-doc-list ... maybe we should support
> ./configure --enable-fake-install in gtk-doc that skips
> all the checks for SGML/XML and doesn't actually install the 
> tools?)

That would be an even nicer solution!

Cheers,

Patrick

Index: modules/thai/thai-x.c
===================================================================
RCS file: /cvs/gnome/pango/modules/thai/thai-x.c,v
retrieving revision 1.24
diff -u -r1.24 thai-x.c
--- modules/thai/thai-x.c	14 Apr 2003 23:48:32 -0000	1.24
+++ modules/thai/thai-x.c	1 Jun 2003 19:29:19 -0000
@@ -30,6 +30,7 @@
 #include <string.h>
 
 #include <glib.h>
+#include "config.h"
 #include "pango-engine.h"
 #include "thai-shaper.h"