How to compile the Manual?

cd doc/manual
# Not too well working native command:  xsltproc ../../build/docbook/xsl/fo/docbook.xsl book.xml >book.fo
java -classpath ../../build/lib/xalan.jar:../../build/lib/xercesImpl.jar:../../build/lib/xml-apis.jar org.apache.xalan.xslt.Process -xsl ../../build/docbook/xsl/fo/docbook.xsl -in book.xml -out book.fo
# Wait, as XSLT takes for ages...
/path/to/xep/xep <book.fo >book.pdf

Read the resulting 575-page book.pdf

Howto regererate part2.xml ( API-reference ) - the quick and dirty way?

  • Adjust paths in oolkit-project/build/docbook/dbdoclet/dbdoclet-tidbit-project
  • You need dbdoclet (tidbit)
  • Start tidbit (cd bin; ./dbdtidbit)
  • Open toolkit-project/build/docbook/dbdoclet/dbdoclet-tidbit-project
  • Check that src-paths are ok
  • Check other settings
  • Hit >DocBook?
  • Copy chapters from toolkit-project/build/docbook/dbdoclet/result/docbook/Reference.xml to part2.xml
  • Search and replace VERSION@ in part2.xml with correct version number