Re: Compile error with make -j2

[David Nečas <yeti physics muni cz>]

On Tue, Oct 27, 2009 at 10:25:19PM +0200, Stefan Kost wrote:
> Andy Spencer schrieb:
> > I'm getting a compiler error when compiling my project "make -j2".
> > I'm not sure if I'm doing something wrong (I haven't configured gtk-doc
> > much) or if other projects would have similar problems.
> > 
> > 
> yes, It seesm to fails. There is a feature request here to support it.
> https://bugzilla.gnome.org/show_bug.cgi?id=543489
> 
> It would be great if you/someone can try to track it down.

Funny because I always build the documentation with -j5 and it works
(not that it is any faster, but -j5 is simply used for everything
including the docs).

The problem occurs only if you don't have foo-docs.xml.

> > Steps to reproduce:
> >   git clone git://lug.rose-hulman.edu/proj/libgis
> >   cd libgis
> >   ./autogen.sh --enable-gtk-doc
> >   make -j2
> > 
> > 
> > Output:
> >   ...
> >   make[2]: Entering directory `/scratch/libgis/docs'
> >   Making all in api
> >   make[3]: Entering directory `/scratch/libgis/docs/api'
> >   make[3]: *** No rule to make target `libgis-docs.sgml', needed by
> >   `html-build.stamp'.  Stop.
> >   make[3]: *** Waiting for unfinished jobs....
> >   make[3]: Leaving directory `/scratch/libgis/docs/api'
> >   make[2]: *** [all-recursive] Error 1
> >   make[2]: Leaving directory `/scratch/libgis/docs'
> >   ...

But foo-docs.xml (or .sgml if you insist) is supposed to be maintained
by a human.  The fact gtkdoc-mkdb attempts to helpfully create it as a
side-effect (one the Makefile has no knowledge of -- which leads to the
error) does not change a tiny bit on that.

The real fix is to stop creating foo-docs.xml in gtkdoc-mkdb because the
file is not usable as-is anyway.  Then everyone is forced to really have
this human-maintained file in the version control system and the above
situation cannot happen.

A suitable foo-docs.xml template can be then provided with gtk-doc (if
it isn't already).

Yeti