Documentation

[David Miller]

David Miller wrote on 7/13/08 5:39 PM:
> Finding a way to make it use the local SGML/XML docbook catalog instead
> of retrieving the files off the web might be useful.
> 
> In trying to debug this so far I've gotten the impression that if you
> declare PUBLIC entity and specify a URL for it, it'll use the URL,
> period.  It only looks it up in the catalog if the URL isn't supplied.
> I can't find any command-line switches for jade to override that either.
> I haven't tested that theory by removing the URLs yet though.

OK, I just tried this, and that theory is indeed correct.  If I remove
the URL entirely (not even a blank param for it), then it uses the local
files specified by the SGML_CATALOG_FILES environment variable.  If the
URL is there, it hits oasis-open.org to grab all of them.  Just removing
the URL from the 3rd line of Bugzilla-Guide.xml completely eliminated
all network access during the docs build, and the docs still build fine.
(well, except for this stupid warning that happens a bazillion times
with or without the URL:
jade:/usr/share/sgml/docbook/xml-dtd-4.1.2-1.0-30.1/ent/iso-cyr1.ent:6:16:E:
"X0430" is not a function name
)

--- en/xml/Bugzilla-Guide.xml	20 May 2008 20:00:52 -0000	1.79
+++ en/xml/Bugzilla-Guide.xml	13 Jul 2008 21:59:50 -0000
@@ -1,6 +1,5 @@
 <?xml version="1.0"?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
-
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" [
     <!ENTITY % myents SYSTEM "bugzilla.ent">
     %myents;



-- 
Dave Miller                                   http://www.justdave.net/
System Administrator, Mozilla Corporation      http://www.mozilla.com/
Project Leader, Bugzilla Bug Tracking System  http://www.bugzilla.org/