Bug 673402

Summary:	Creating a (distributed) set creates invalid docbook
Product:	[Community] Publican	Reporter:	Rebecca Newton <rnewton>
Component:	publican	Assignee:	Ruediger Landmann <rlandman+disabled>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Ruediger Landmann <rlandman+disabled>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	future	CC:	jfearn, mmcallis, publican-list
Target Milestone:	---
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:	2.6	Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2011-07-26 00:42:40 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:

Description Rebecca Newton 2011-01-28 04:23:18 UTC

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>&#60;xi:include href=&#34;My_Other_Book/My_Other_Book.xml&#34; xmlns:xi=&#34;http://www.w3.org/2001/XInclude&#34;&#62;</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):


How reproducible:
Follow the instructions in the Publican User Guide to create a distributed set and try to build it!

Steps to Reproduce:
1.
2.
3.
  
Actual results:


Expected results:


Additional info:

Comment 1 Jeff Fearn 🐞 2011-02-14 06:21:28 UTC

Added many calls to maketext to allow default texts to be translated for create book.

Committed revision 1716.

Comment 2 Jeff Fearn 🐞 2011-02-14 06:22:20 UTC

oops, comment id for a different bug ... how embarrassment!

Comment 3 Jeff Fearn 🐞 2011-03-21 05:55:56 UTC

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.

Comment 4 Jeff Fearn 🐞 2011-07-05 11:29:01 UTC

Back ported to branches/publican-2x

Committed revision 1803.

Comment 5 Rebecca Newton 2011-07-12 05:19:04 UTC

Warnings are evident in the Publican output when building a set for the first time. This highlights the sections that need to change.