Menu

Commit [r4712]  Maximize  Restore  History

Docs: Important: migrated build process from docbook2html and docbook2pdf to the generic xsltproc tool. This requires xsltproc on the path (/usr/bin on CSNet) and the variable DOCBOOK_XSL_HOME to point to the DocBook style sheets (/usr/share/sgml/docbook/xsl-stylesheets-1.69.1-5.1 on CSNet). This migration was necessary because it's difficult to *find* docbook2html and docbook2pdf anymore. The community seems to have moved to XML-processing tools.

(It would be nice to eliminate the dependency on xsltproc as well. A variety of Java tools are available and could be bundled in lib/buildlib, but none of them seem to handle the DocBook styles correctly: the built-in Java APIs choke on the style definition; Xalan runs, but leaves the table-of-contents pages blank; Saxon doesn't support "chunking" -- converting a document to multiple HTML pages.)

The change in tools required some tweaking of image pointers: the only way to get consistent images of a reasonable size in both the HTML and PDF output seems to be by using a 'width="80%"' attribute (other percentages work too, of course).

Also made some changes in the developer docs:
- Some cleanup (related to recent changes in build scripts)
- Filled in stubs in a lot of "Supporting Technology" tools with some basic information.
- Put together an outline of milestones in the "History" section.
- Created a "Supporting Technology" section devoted to legacy tools/libraries (things we no longer use).
- Added stub sections to the "System Architecture" section.

dlsmith 2009-01-22

changed /trunk/docs/build.xml
added /trunk/docs/lib
added /trunk/docs/lib/buildlib
added /trunk/docs/lib/buildlib/avalon-framework-4.2.0.jar
added /trunk/docs/lib/buildlib/batik-all-1.7.jar
added /trunk/docs/lib/buildlib/commons-io-1.3.1.jar
added /trunk/docs/lib/buildlib/commons-logging-1.0.4.jar
added /trunk/docs/lib/buildlib/fop.jar
added /trunk/docs/lib/buildlib/xmlgraphics-commons-1.3.1.jar
added /trunk/docs/lib/readme.txt
changed /trunk/docs/src/developer/devdoc.docbook
changed /trunk/docs/src/developer/gettingStarted.docbook
changed /trunk/docs/src/developer/introduction.docbook
changed /trunk/docs/src/developer/projectAdministration.docbook
changed /trunk/docs/src/developer/supportingTechnology.docbook
changed /trunk/docs/src/developer/systemArchitecture.docbook
changed /trunk/docs/src/quickstart/quickstart.docbook
changed /trunk/docs/src/user/userdoc.docbook
/trunk/docs/build.xml Diff Switch to side-by-side view
Loading...
/trunk/docs/lib
Directory.
/trunk/docs/lib/buildlib/fop.jar
Binary file was added.
/trunk/docs/lib/readme.txt Diff Switch to side-by-side view
Loading...
/trunk/docs/src/developer/devdoc.docbook Diff Switch to side-by-side view
Loading...
/trunk/docs/src/developer/gettingStarted.docbook Diff Switch to side-by-side view
Loading...
/trunk/docs/src/developer/introduction.docbook Diff Switch to side-by-side view
Loading...
/trunk/docs/src/developer/projectAdministration.docbook Diff Switch to side-by-side view
Loading...
/trunk/docs/src/developer/supportingTechnology.docbook Diff Switch to side-by-side view
Loading...
/trunk/docs/src/developer/systemArchitecture.docbook Diff Switch to side-by-side view
Loading...
/trunk/docs/src/quickstart/quickstart.docbook Diff Switch to side-by-side view
Loading...
/trunk/docs/src/user/userdoc.docbook Diff Switch to side-by-side view
Loading...
MongoDB Logo MongoDB