Red Hat Bugzilla – Bug 673402
Creating a (distributed) set creates invalid docbook
Last modified: 2011-07-25 20:42:40 EDT
Description of problem:
That is, I created a <set> example and the default set.xml file contained tags that were invalid as a child of <set>. <remark>, <index>, and Revision_History (appendix) all throw errors when building. Here is the content as copied directly from the .xml file:
<remark>NOTE: the href does not contain a language! This is CORRECT!</remark><remark><xi:include href="My_Other_Book/My_Other_Book.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></remark>
<xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include><index></index>
Version-Release number of selected component (if applicable):
Follow the instructions in the Publican User Guide to create a distributed set and try to build it!
Steps to Reproduce:
Added many calls to maketext to allow default texts to be translated for create book.
Committed revision 1716.
oops, comment id for a different bug ... how embarrassment!
I changed index to setindex, and removed the Revision History xi:include. The remarks really have to stay as there is no other way for an author to know what customisations they _have_ to make to build a proper distributed set.
Handing over to Rudi to have the Set documentation updated to explain this need.
Back ported to branches/publican-2x
Committed revision 1803.
Warnings are evident in the Publican output when building a set for the first time. This highlights the sections that need to change.