From 845248d9f9da0bbc57b3fb9308cbb2a828bd47c3 Mon Sep 17 00:00:00 2001 From: "barnboy%trilobyte.net" <> Date: Wed, 21 Nov 2001 00:41:23 +0000 Subject: Changed openjade compilation instructions to match new commands required by XML conversion of the Guide. --- docs/README.docs | 22 +++++++++++++++++----- 1 file changed, 17 insertions(+), 5 deletions(-) (limited to 'docs/README.docs') diff --git a/docs/README.docs b/docs/README.docs index 4ccd7044d..b490c83b6 100644 --- a/docs/README.docs +++ b/docs/README.docs @@ -106,23 +106,35 @@ NOTES: Here are the commands I use to maintain this documentation. You MUST have DocBook 4.1 set up correctly in order for this to work. - Substitute your own path to "ldp.dsl" for "$LDP_HOME". + Substitute your own path to "ldp.dsl" for "$LDP_HOME". Additionally, + there is now a dependency on "xml.dcl" since we converted the Guide + to XML. Note that below, it is hard-coded to + /usr/share/doc/openjade-1.3/pubtext/xml.dcl. Modify it to point to + openjade's xml.dcl on your system. To create HTML documentation: bash$ cd html -bash$ jade -t sgml -i html -d $LDP_HOME/ldp.dsl\#html \ -../sgml/Bugzilla-Guide.sgml +bash$ jade -t sgml -i html -d $LDP_HOME/ldp.dsl\#html \ +/usr/share/doc/openjade-1.3/pubtext/xml.dcl ../sgml/Bugzilla-Guide.sgml To create HTML documentation as a single big HTML file: bash$ cd html -bash$ jade -V nochunks -t sgml -i html -d $LDP_HOME/ldp.dsl\#html \ -../sgml/Bugzilla-Guide.sgml >Bugzilla-Guide.html +bash$ jade -V nochunks -t sgml -i html -d $LDP_HOME/ldp.dsl\#html \ +/usr/share/doc/openjade-1.3/pubtext/xml.dcl ../sgml/Bugzilla-Guide.sgml To create TXT documentation as a single big TXT file: bash$ cd txt bash$ lynx -dump -nolist ../html/Bugzilla-Guide.html >Bugzilla-Guide.txt + +## Change for XML +There's a small change in how you use Jade now that we've converted the +Bugzilla Guide to XML from SGML. Now call Jade this way to compile HTML +documentation: + +(I need to remove the hard-coded path to xml.dcl for openjade) + Sincerely, Matthew P. Barnson The Bugzilla "Doc Knight" -- cgit v1.2.3-24-g4f1b