Re: DocBook 4.1.2 XML Weirdness (gtk-doc install fails)
Hi Ryan,
Thank you for the response. I thought I searched for a reference to this issue, but apparently not well enough. ;-)
Well, I'd only just sent the email I mentioned when I gave you the link, so it's not surprising that you hadn't seen it :-) I've committed the fix for your problem in revision 25899 [1], so you should be able to upgrade the docbook-xml-4.1.2 port once the PortIndex has been updated on the server (in at most 12 hours) and gtk-doc should then install. Let me (and the list) know if it doesn't.
I really appreciate all the great work you guys have done here. After years, I finally got work to buy me a Mac and I'm happy to see that there is a community that takes advantage of it's BSD underpinnings.
Thanks for the thanks! I'm sure that you're far from the only one attracted to Macs now that the OS is based on UNIX -- though I must admit I bought my first Mac simply because it was the cheapest laptop with a combo drive at the time :-) Kind regards, Maun Suang [1] http://trac.macports.org/projects/macports/changeset/25899 -- Boey Maun Suang (Boey is my surname) Email: boeyms at macports dot org
I'm getting more gtk-doc weirdness, and I only installed it earlier tonight. The error was: I/O error : Attempt to load network entity http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl" compilation error: file /opt/local/share/gtk-doc/data/gtk-doc.xsl line 6 element import xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl ^^ whats interesting about this error is that its nothing to do with the catalog, since the entities that arent resolved are all URLs. The failing command was: gtkdoc-mkhtml cairo ../cairo-docs.xml (I was building cairo's docs from git with 'make doc'.) So I tried this: sh -x `which gtkdoc-mkhtml` cairo ../cairo-docs.xml and got: ... after some faff + /opt/local/bin/xsltproc --nonet --xinclude --stringparam gtkdoc.bookname cairo --stringparam gtkdoc.version 1.8 /opt/local/share/gtk-doc/data/gtk-doc.xsl ../cairo-docs.xml ... then the error. The problem is --nonet. The combination of nonet and absolute urls (rather than local catalog references) obviously can't work. Any idea how I could have ended up with this combo? Is there something in macports filling in absolute urls without turning off --nonet? Cheers, Baz On 05/06/07, Boey Maun Suang <boeyms@macports.org> wrote:
Hi Ryan,
Thank you for the response. I thought I searched for a reference to this issue, but apparently not well enough. ;-)
Well, I'd only just sent the email I mentioned when I gave you the link, so it's not surprising that you hadn't seen it :-)
I've committed the fix for your problem in revision 25899 [1], so you should be able to upgrade the docbook-xml-4.1.2 port once the PortIndex has been updated on the server (in at most 12 hours) and gtk-doc should then install. Let me (and the list) know if it doesn't.
I really appreciate all the great work you guys have done here. After years, I finally got work to buy me a Mac and I'm happy to see that there is a community that takes advantage of it's BSD underpinnings.
Thanks for the thanks! I'm sure that you're far from the only one attracted to Macs now that the OS is based on UNIX -- though I must admit I bought my first Mac simply because it was the cheapest laptop with a combo drive at the time :-)
Kind regards,
Maun Suang
[1] http://trac.macports.org/projects/macports/changeset/25899
-- Boey Maun Suang (Boey is my surname) Email: boeyms at macports dot org
_______________________________________________ macports-users mailing list macports-users@lists.macosforge.org http://lists.macosforge.org/mailman/listinfo/macports-users
Hi Baz, On 09/06/2007, at 09:04, Baz wrote:
I'm getting more gtk-doc weirdness, and I only installed it earlier tonight. The error was:
I/O error : Attempt to load network entity http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl" compilation error: file /opt/local/share/gtk-doc/data/gtk-doc.xsl line 6 element import xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl
^^ whats interesting about this error is that its nothing to do with the catalog, since the entities that arent resolved are all URLs.
Actually, the problem probably is the catalog; remapping such URLs is precisely one of the things it's supposed to do. It sounds to me like your docbook-xsl port is out of date. Could you try upgrading it and then installing gtk-doc again? Hopefully that should fix it (unless you have a local catalog somewhere else that might be mucking it up). Kind regards, Maun Suang -- Boey Maun Suang (Boey is my surname) Email: boeyms at macports dot org
On 09/06/07, Boey Maun Suang <boeyms@macports.org> wrote:
Actually, the problem probably is the catalog; remapping such URLs is precisely one of the things it's supposed to do.
You're right; I took a closer look this morning.
It sounds to me like your docbook-xsl port is out of date. Could you try upgrading it and then installing gtk-doc again? Hopefully that should fix it (unless you have a local catalog somewhere else that might be mucking it up).
Tried that already, but did it again to be sure...I messed around a bit more and it was just this: XML_CATALOG_FILES=/opt/local/etc/xml/catalog /opt/local/bin/xsltproc --nonet --xinclude --stringparam gtkdoc.bookname cairo --stringparam gtkdoc.version 1.8 /opt/local/share/gtk-doc/data/gtk-doc.xsl ../cairo-docs.xml ... and I see the default setting (file:///etc/xml/catalog - no ${prefix}) is hardcoded into both libxml2 (catalog.c) and xsltproc (xsltproc.c), so I needed to set this variable to get those tools working on macports. Hrrmrm. Thats pretty annoying. My own problem is fixed but I imagine this will come up again - I see there's a couple of ports that set this as part of their build instructions. So possible solutions: - tell me to rtfm :) - I could roll a patch for libxml2, libxslt so that they use ${prefix} for the default catalog, for macports only - I could suggest that patch upstream. - other...?
Kind regards,
Maun Suang
Thanks for your help, Baz
-- Boey Maun Suang (Boey is my surname) Email: boeyms at macports dot org
Hi Baz,
XML_CATALOG_FILES=/opt/local/etc/xml/catalog /opt/local/bin/xsltproc --nonet --xinclude --stringparam gtkdoc.bookname cairo --stringparam gtkdoc.version 1.8 /opt/local/share/gtk-doc/data/gtk-doc.xsl ../cairo-docs.xml
... and I see the default setting (file:///etc/xml/catalog - no ${prefix}) is hardcoded into both libxml2 (catalog.c) and xsltproc (xsltproc.c), so I needed to set this variable to get those tools working on macports.
Ah, yes, I know all about this, and didn't think of it at the time. Sorry :-)
So possible solutions: - tell me to rtfm :) - I could roll a patch for libxml2, libxslt so that they use ${prefix} for the default catalog, for macports only - I could suggest that patch upstream. - other...?
I've discussed this with the maintainer of libxml2 and mailed him a patch for his consideration a few weeks ago, but unfortunately he hasn't gotten back to me about it yet. I've now put a ticket on Trac so that others can see it [1]; I've only recommended the substitutions in some of the places that "/etc" appears because the other instances appear in documentation that seems less system- specific. My impression from the libxslt code was that it inherited the default catalog location from whatever was compiled into the libxml2 code, but that there are hardcoded references in its documentation (including the printf in xsltproc.c) that ought to be changed. I think you're absolutely right, however, that this is an issue that ought to be reported upstream. If you could do that (possibly improving on my patches), that would be great. Kind regards, Maun Suang [1] http://trac.macports.org/projects/macports/ticket/12106 -- Boey Maun Suang (Boey is my surname) Email: boeyms at macports dot org
participants (2)
-
Baz
-
Boey Maun Suang