Bug 602239 - docs are not valid xml
Summary: docs are not valid xml
Alias: None
Product: Fedora
Classification: Fedora
Component: pacemaker   
(Show other bugs)
Version: 13
Hardware: All
OS: Linux
Target Milestone: ---
Assignee: Andrew Beekhof
QA Contact: Fedora Extras Quality Assurance
Depends On:
TreeView+ depends on / blocked
Reported: 2010-06-09 13:00 UTC by Dan Horák
Modified: 2011-01-19 08:06 UTC (History)
7 users (show)

Fixed In Version: pacemaker-1.1.2-2.fc13
Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
Last Closed: 2011-01-19 08:06:20 UTC
Type: ---
Regression: ---
Mount Type: ---
Documentation: ---
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---

Attachments (Terms of Use)
fix for the docs (704 bytes, application/octet-stream)
2010-06-10 11:01 UTC, Dan Horák
no flags Details

Description Dan Horák 2010-06-09 13:00:37 UTC
Description of problem:
version 1.6.3 of publican breaks pacemaker builds due an error during documentation generation

Version-Release number of selected component (if applicable):

Steps to Reproduce:
1. do a build of pacemaker (eg. a scratch build in koji - http://koji.fedoraproject.org/koji/taskinfo?taskID=2240497)

Additional info:
log from successful build using publica 1.6.2 - http://kojipkgs.fedoraproject.org/packages/pacemaker/1.1.2/1.fc13/data/logs/x86_64/build.log
log with an error - http://koji.fedoraproject.org/koji/getfile?taskID=2240501&name=build.log

or on Fedora/s390x is much cleaner situation - the difference between the 2 buildroots is only in the publican package (1.6.2 vs. 1.6.3), see

It's quite possible that the pacemaker docs have problem, because the error is about validation, but in that case I would appreciate help or pointers.

Comment 1 Ruediger Landmann 2010-06-09 14:03:22 UTC
The XML is invalid. 

The content model for <imagedata> is EMPTY[1] and therefore this tag must not contain data.

However, in the Book_Info.xml file in pacemaker-1.1.2-1.fc13.src.rpm, I found:

    <imagedata fileref="Common_Content/images/title_logo.svg" format="SVG">

Here, the <imagedata> tag contains the spaces used to indent the closing tag on the following line.

Changing this to

    <imagedata fileref="Common_Content/images/title_logo.svg" format="SVG"/>


    <imagedata fileref="Common_Content/images/title_logo.svg" format="SVG"/></imagedata>

fixes the problem and lets the doc build normally on my system. If you make this change, can you build on Koji successfully?


[1] http://www.docbook.org/tdg/en/html/imagedata.html

Comment 2 Ruediger Landmann 2010-06-09 14:05:03 UTC
(In reply to comment #1)

> <imageobject>
>     <imagedata fileref="Common_Content/images/title_logo.svg"
> format="SVG"/></imagedata>
> </imageobject>

Sorry -- this should be

    <imagedata fileref="Common_Content/images/title_logo.svg" 

of course...

Comment 3 Dan Horák 2010-06-10 10:59:25 UTC
Ruediger, thanks, with that update pacemaker builds fine on F-13 with publican 1.6.3. But when testing the builds I have found that latest publican in Rawhide is 1.6.2 because the 1.6.3 build failed there.

I am switching the component to pacemaker and updating the summary because the real bug is there.

Comment 4 Dan Horák 2010-06-10 11:01:50 UTC
Created attachment 422861 [details]
fix for the docs

Comment 5 Andrew Beekhof 2010-06-11 12:29:41 UTC
Thanks for the patch.

Note You need to log in before you can comment on or make changes to this bug.