Red Hat Bugzilla – Bug 565498
User Guide unclear
Last modified: 2010-11-23 23:20:20 EST
Description of problem: Within Appenix C of the User Guid at http://jfearn.fedorapeople.org/Publican/appe-Users_Guide-publican.cfg_parameters.html it says: "catalogs the path to the DocBook catalog files. (Default for Linux operating systems: /usr/share/publican/xsl ". The path seems to be wrong.
Version-Release number of selected component (if applicable): 1.4
How reproducible: read manual
Steps to Reproduce:
1. open http://jfearn.fedorapeople.org/Publican/appe-Users_Guide-publican.cfg_parameters.html
I am pretty unsure if that parameted does something at all... Maybe you could clearify how to add my own catalog files for a docbook xml extension?!
catalogs is no longer used in Publican, it was used in Publican 0.x because we shipped updated DTDs on some Linux platforms. It must have escaped notice during the Publican 1 rewrite.
I removed all references to catalogs in the code and Users Guide. In the code it was in the cofig file handling code but was not used anywhere else.
You "should" be able to override the system catalog by exporting XML_CATALOG_FILE before calling publican.
FYI to use catalogs to change the DTD being loaded you'd have to be naughty and hijack the DocBook URIs. To actually change the DTD being referenced you'd need to change the hard coded DTDs in lib/Publican/Builder.pm
publican-1.5-0.fc12 has been submitted as an update for Fedora 12.
publican-1.5-0.fc13 has been submitted as an update for Fedora 13.
publican-1.5-0.fc11 has been submitted as an update for Fedora 11.
publican-1.5-0.fc12 has been pushed to the Fedora 12 stable repository. If problems still persist, please make note of it in this bug report.
publican-1.5-0.fc11 has been pushed to the Fedora 11 stable repository. If problems still persist, please make note of it in this bug report.