gtkdoc problem

[Todd Zullinger]

Erwin Rol wrote:
> I ran into problems with some stuff i was working on, but to be sure it
> isn't my own poor automake knowledge I just downloaded the official glib
> tar.gz (not rpm) sources and used those to test (with the same result). 

Okay.  I grabbed glib-2.16.3 and successfully built it with:

./configure --enable-gtk-doc && make

I tried adding --verbose to the xsltproc call in gtkdoc-mkhtml but it
made it take longer than I was willing to wait.  Instead, I used
strace on xsltproc to see what files it was reading.

Anyway, perhaps you'd like to poke through the output and see what
files you might be missing.  The gzipped strace output is at:

http://tmz.fedorapeople.org/tmp/xsltproc.strace.gz

The trivial diff for the gtkdoc-mkhtml change is:

--- gtkdoc-mkhtml.orig	2008-01-08 10:39:11.000000000 -0500
+++ gtkdoc-mkhtml	2008-07-01 17:33:05.000000000 -0400
@@ -42,7 +42,7 @@
 fi
 
 if $is_xml; then
-  /usr/bin/xsltproc --nonet --xinclude \
+  strace -o /tmp/xsltproc.strace /usr/bin/xsltproc --verbose --nonet --xinclude \
       --stringparam gtkdoc.bookname $module \
       --stringparam gtkdoc.version "1.9" \
       $gtkdocdir/gtk-doc.xsl $document || exit $?

I grepped the strace for files it was opening and I think they boiled
down to coming from the following packages:

docbook-dtds-1.0-35.fc9.noarch
docbook-style-xsl-1.73.2-9.fc9.noarch
gtk-doc-1.9-4.fc9.noarch
xml-common-0.6.3-23.fc9.noarch

> OK that than explains why the --nonet is there. But some ppl might want
> to be able to load things from the net. Would it be an idea to have
> something like a --enable-net option for gtkdoc-mkhtml ? That way ppl
> can just add that option in their Makefile.am and there is no change to
> the Fedora buildsystem. 

You'd have to persuade the gtkdoc upstream of that. :)

-- 
Todd        OpenPGP -> KeyID: 0xBEAF0CE3 | URL: www.pobox.com/~tmz/pgp
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Victory is Mine!
    -- Stewie Griffin

-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 542 bytes
Desc: not available
URL: <http://listman.redhat.com/archives/fedora-list/attachments/20080701/a3a742e0/attachment-0001.sig>