[xml/sgml-pkgs] Bug#514402: FTBFS: non-valid XML document doc/apt-get.8.xml

[Daniel Leidert]

reassign 514402 apt
found 514402 apt/0.7.20.1
retitle 514402 FTBFS: non-valid XML document doc/apt-get.8.xml
thanks

Reassigning back. Fix(es) attached.

Hi guys,

xmlto reports you an error in an XML document, which is clearly a bug in
apt, not in xmlto. The recent change in xmlto added a switch to the
xmllint call to resolve entities in XML documents. Thus the resulting
document resolves to:

> [..]
> <refsect1>
> 	 <title>CURRENT AUTHORS</title>
> 	 <para>
> 		 
>    <author>
>     <othername>APT team</othername>
>    </author>
> 
> 		 
> 	<para>
> 		<ulink url="http://packages.qa.debian.org/a/apt.html">QA Page</ulink>
> 	</para>
> 
> 	 </para>
>  </refsect1>
> [..]

Please note the nested <para> elements. But that's not valid, as <para>
is not declared to be a possible children of itself. See
http://www.docbook.org/tdg/en/html/para.html.

So your XML document is not valid:

> xmllint --noout --noent --valid ./doc/apt-get.8.xml ; echo $?
> ./doc/apt-get.8.xml:585: element para: validity error : Element para is not declared in para list of possible children
> 	 </para>
> 	        ^
> 4

You could fix the XML source in various ways: (a) Only surround the
apt-author.team entity by <para> or (b) Remove your self-written
ORIGINAL AUTHORS and CURRENT AUTHORS sections as the AUTHORS section is
already automatically created (see `man apt-get' -> Section "AUTHORS"
after your self-written sections) or (c) skip validation by using xmltos
--skip-validation switch (IMHO worst choice).

For the moment I suggest you simply use option (a) for which I attached
the fix and change to option (b) later (snippet attached too).

Regards, Daniel
-------------- next part --------------
A non-text attachment was scrubbed...
Name: surround_just_author_ent.diff
Type: text/x-patch
Size: 291 bytes
Desc: not available
Url : http://lists.alioth.debian.org/pipermail/debian-xml-sgml-pkgs/attachments/20090207/18df335a/attachment.bin 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: authorgroup.xml
Type: application/xml
Size: 458 bytes
Desc: not available
Url : http://lists.alioth.debian.org/pipermail/debian-xml-sgml-pkgs/attachments/20090207/18df335a/attachment.xml