Compile error with make -j2

[Andy Spencer-3]

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.


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'
  ...


_______________________________________________
gtk-doc-list mailing list
gtk-doc-list@...
http://mail.gnome.org/mailman/listinfo/gtk-doc-list

[Stefan Kost]

hi,

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.

Stefan

> 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'
>   ...
>
>
> ------------------------------------------------------------------------
>
> _______________________________________________
> gtk-doc-list mailing list
> gtk-doc-list@...
> http://mail.gnome.org/mailman/listinfo/gtk-doc-list

_______________________________________________
gtk-doc-list mailing list
gtk-doc-list@...
http://mail.gnome.org/mailman/listinfo/gtk-doc-list

[David Nečas (Yeti)-2]

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

_______________________________________________
gtk-doc-list mailing list
gtk-doc-list@...
http://mail.gnome.org/mailman/listinfo/gtk-doc-list