Documentation

[David Miller]

Colin Ogilvie wrote on 7/13/08 1:17 PM:
> David Miller wrote:
>> XMLTO_Documentation_Branch works for me.
> 
> I've started work on this today, and have made some initial checkins for
> https://bugzilla.mozilla.org/show_bug.cgi?id=423496 (all the details are
> on the bug) and by process of this, 2 of the 3 dependant bugs will also
> be resolved if this was committed as is.
> 
> Unfortunately, I'm still looking at the PDF stuff as it's still
> producing a load of rubbish to STDERR :(

While you're at it, the HTML generation is hanging periodically on the
website.  Seems to be related to it needing to retrieve DTD files off
oasis-open.org in order to build (despite having copies of those files
locally on the machine) and oasis-open.org is rate-limiting us because
we're pulling too much at once (trying to build 3 copies of the docs -
twice for HTML and once for PDF - times 4 to 8 versions of bugzilla that
we have docs on the website for).

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.

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