gtkdoc problem

2008-07-01 Thread Erwin Rol
Hello all,

I have a problem with gtkdoc on Fedora 9. It doesn't want to resolve
external references like;


http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"; [
]>

After trying to see if it was a network problem i noticed that there was
never any network traffic for that URL. With strace i noticed it tried
to stat() the URL and that of course returns an error. 

When i than looked into gtkdoc-mkhtml i found a --nonet option was used
for xsltproc. When i removed that option everything worked fine. (I also
tried this with the glib sources, not just my own stuff).

The following patch does the trick;

--- /usr/bin/gtkdoc-mkhtml.orig 2008-07-01 15:45:25.0 +0200
+++ /usr/bin/gtkdoc-mkhtml  2008-07-01 15:45:34.0 +0200
@@ -42,7 +42,7 @@
 fi
 
 if $is_xml; then
-  /usr/bin/xsltproc --nonet --xinclude \
+  /usr/bin/xsltproc --xinclude \
   --stringparam gtkdoc.bookname $module \
   --stringparam gtkdoc.version "1.9" \
   $gtkdocdir/gtk-doc.xsl $document || exit $?


But somehow this can't be the right solution :-) anybody know what the
real fix for the problem is ?

TIA,

Erwin




-- 
fedora-list mailing list
fedora-list@redhat.com
To unsubscribe: https://www.redhat.com/mailman/listinfo/fedora-list


Re: gtkdoc problem

2008-07-01 Thread Todd Zullinger
Erwin Rol wrote:
> I have a problem with gtkdoc on Fedora 9. It doesn't want to resolve
> external references like;
> 
> 
>  
> "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"; [
> ]>
> 
> After trying to see if it was a network problem i noticed that there was
> never any network traffic for that URL. With strace i noticed it tried
> to stat() the URL and that of course returns an error. 
> 
> When i than looked into gtkdoc-mkhtml i found a --nonet option was used
> for xsltproc. When i removed that option everything worked fine. (I also
> tried this with the glib sources, not just my own stuff).
> 
> The following patch does the trick;
> 
> --- /usr/bin/gtkdoc-mkhtml.orig   2008-07-01 15:45:25.0 +0200
> +++ /usr/bin/gtkdoc-mkhtml2008-07-01 15:45:34.0 +0200
> @@ -42,7 +42,7 @@
> fi
> 
> if $is_xml; then
> -  /usr/bin/xsltproc --nonet --xinclude \
> +  /usr/bin/xsltproc --xinclude \
>   --stringparam gtkdoc.bookname $module \
>   --stringparam gtkdoc.version "1.9" \
>   $gtkdocdir/gtk-doc.xsl $document || exit $?
> 
> 
> But somehow this can't be the right solution :-) anybody know what the
> real fix for the problem is ?

You're probably missing a dockbook package.  I believe it may be
docbook-dtds (which provides docbookx.dtd), but I'm not sure.  I have
run into this problem before and it was invariably a missing package
with needed docbook dtd's or other parts.

Hopefully that gets you going in the right direction.

-- 
ToddOpenPGP -> KeyID: 0xBEAF0CE3 | URL: www.pobox.com/~tmz/pgp
~~
Abstainer, n.:
A weak person who yields to the temptation of denying himself a
pleasure.
-- Ambrose Bierce, "The Devil's Dictionary"



pgpt3auBLzeLC.pgp
Description: PGP signature
-- 
fedora-list mailing list
fedora-list@redhat.com
To unsubscribe: https://www.redhat.com/mailman/listinfo/fedora-list

Re: gtkdoc problem

2008-07-01 Thread Erwin Rol
On Tue, 2008-07-01 at 12:14 -0400, Todd Zullinger wrote:
> Erwin Rol wrote:

> You're probably missing a dockbook package.  I believe it may be
> docbook-dtds (which provides docbookx.dtd), but I'm not sure.  I have
> run into this problem before and it was invariably a missing package
> with needed docbook dtd's or other parts.

docbook-dtds-1.0-35.fc9.noarch is installed on my system. But I don't
think that is the root of the problem. The SGML files have a reference
to a http URL, not a local file. And gtkdoc-mkhtml seems to decide that
it will not load anything from the net.

> Hopefully that gets you going in the right direction.

Well i "fixed" gtkdoc-mkhtml by removing the --nonet, so for now it is
OK, but I am just wondering if it is just me being stupid, or if the
tool is broken.

- Erwin


-- 
fedora-list mailing list
fedora-list@redhat.com
To unsubscribe: https://www.redhat.com/mailman/listinfo/fedora-list


Re: gtkdoc problem

2008-07-01 Thread Todd Zullinger
Erwin Rol wrote:
> docbook-dtds-1.0-35.fc9.noarch is installed on my system. But I
> don't think that is the root of the problem. The SGML files have a
> reference to a http URL, not a local file. And gtkdoc-mkhtml seems
> to decide that it will not load anything from the net.

I'm still of the opinion that this is caused by missing packages, as
it has been in the cases I've run across.  What is it that you're
building?  Can you post the output (or a link to it if it's really
large)?

> Well i "fixed" gtkdoc-mkhtml by removing the --nonet, so for now it is
> OK, but I am just wondering if it is just me being stupid, or if the
> tool is broken.

When building official fedora packages, mock doesn't have a network
connection on the buildsystem, so removing the --nonet wouldn't work
there and we need to find a better solution. :)

It might help to add the --verbose flag to the xsltproc call in
gtkdoc-mkhtml.

-- 
ToddOpenPGP -> KeyID: 0xBEAF0CE3 | URL: www.pobox.com/~tmz/pgp
~~
Duct tape is like the Force. It has a light side, a dark side, and it
holds the universe together
-- Carl Zwanzig



pgpTETY8XK5WX.pgp
Description: PGP signature
-- 
fedora-list mailing list
fedora-list@redhat.com
To unsubscribe: https://www.redhat.com/mailman/listinfo/fedora-list

Re: gtkdoc problem

2008-07-01 Thread Erwin Rol
On Tue, 2008-07-01 at 15:40 -0400, Todd Zullinger wrote:
> Erwin Rol wrote:
> > docbook-dtds-1.0-35.fc9.noarch is installed on my system. But I
> > don't think that is the root of the problem. The SGML files have a
> > reference to a http URL, not a local file. And gtkdoc-mkhtml seems
> > to decide that it will not load anything from the net.
> 
> I'm still of the opinion that this is caused by missing packages, as
> it has been in the cases I've run across.  What is it that you're
> building?  Can you post the output (or a link to it if it's really
> large)?

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

> > Well i "fixed" gtkdoc-mkhtml by removing the --nonet, so for now it is
> > OK, but I am just wondering if it is just me being stupid, or if the
> > tool is broken.
> 
> When building official fedora packages, mock doesn't have a network
> connection on the buildsystem, so removing the --nonet wouldn't work
> there and we need to find a better solution. :)

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. 


> It might help to add the --verbose flag to the xsltproc call in
> gtkdoc-mkhtml.

- Erwin


-- 
fedora-list mailing list
fedora-list@redhat.com
To unsubscribe: https://www.redhat.com/mailman/listinfo/fedora-list


Re: gtkdoc problem

2008-07-01 Thread 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.0 -0500
+++ gtkdoc-mkhtml   2008-07-01 17:33:05.0 -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. :)

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



pgpJGZyEk3c0N.pgp
Description: PGP signature
-- 
fedora-list mailing list
fedora-list@redhat.com
To unsubscribe: https://www.redhat.com/mailman/listinfo/fedora-list

Re: gtkdoc problem

2008-07-01 Thread Tim
On Tue, 2008-07-01 at 16:21 +0200, Erwin Rol wrote:
> I have a problem with gtkdoc on Fedora 9. It doesn't want to resolve
> external references like;
> 
> 
>  
> "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"; [
> ]>
> 
> After trying to see if it was a network problem i noticed that there was
> never any network traffic for that URL. With strace i noticed it tried
> to stat() the URL and that of course returns an error. 
> 
> When i than looked into gtkdoc-mkhtml i found a --nonet option was used
> for xsltproc. When i removed that option everything worked fine. (I also
> tried this with the glib sources, not just my own stuff).

I wonder if it's expected to work like the ideal (*) web browser:  They
don't fetch the DTDs, they have internal copies of the standard known
DTDs, and only fetch the ones that they need to.

In reality, web browsers pay scant regard to specs, but the behaviour I
outlined is a textbook DTD handling methodology.  After all, you
wouldn't want to go fetching the DTD each time you read standard HTML,
it's rather wasteful, seeing as the DTDs don't change.

-- 
[EMAIL PROTECTED] ~]$ uname -r
2.6.25.6-55.fc9.i686

Don't send private replies to my address, the mailbox is ignored.  I
read messages from the public lists.



-- 
fedora-list mailing list
fedora-list@redhat.com
To unsubscribe: https://www.redhat.com/mailman/listinfo/fedora-list


Re: gtkdoc problem

2008-07-06 Thread Erwin Rol

On Tue, 2008-07-01 at 19:13 -0400, Todd Zullinger wrote:
> 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.orig2008-01-08 10:39:11.0 -0500
> +++ gtkdoc-mkhtml 2008-07-01 17:33:05.0 -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

Well I fixed the problem, but I have no idea what was wrong. The fix
was uninstall gtkdoc and several docbook rpms, and reinstall them, and
after that tings worked fine. The install is a x86_64 clean F9, not some
F8->F9 update, so i have no idea why it didn't work before. 

- Erwin



-- 
fedora-list mailing list
fedora-list@redhat.com
To unsubscribe: https://www.redhat.com/mailman/listinfo/fedora-list