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
--- doc/apt-get.8.xml.orig	2009-02-07 13:43:56.000000000 +0100
+++ doc/apt-get.8.xml	2009-02-07 13:45:07.000000000 +0100
@@ -581,8 +581,8 @@
 	 <title>CURRENT AUTHORS</title>
 	 <para>
 		 &apt-author.team;
-		 &apt-qapage;
 	 </para>
+		 &apt-qapage;
  </refsect1>
  &manbugs;
 </refentry>

Attachment: authorgroup.xml
Description: XML document

Reply via email to