[xml/sgml-pkgs] Bug#483503: xmlto is confused by cross-references into an external entity.

[Daniel Burrows]

Package: xmlto
Version: 0.0.20-1
Severity: normal

  I was just experimenting with using xmlto on the aptitude documentation.
I didn't get very far.

  aptitude's documentation is split into a manpage and the main body of
the docs. (this is for the convenience of translators -- they can just
translate the manpage if they want)  The manpage is incorporated into
the main document via what I believe is an external entity, unless I'm
getting my XML terminology wrong:

    <!ENTITY manpage SYSTEM "manpage.xml">

  When I run xmlto on the aptitude docs, it fails and prints a bunch of
"validity errors" like this:

    /home/daniel/programming/aptitude/head/doc/en/aptitude.xml:9570: element link: validity error : IDREF attribute linkend references an unknown ID "cmdlineOptionSafeUpgradeNoNewInstalls"

  The problem is, an element with that ID *does* exist, in manpage.xml.
It looks like xmlto is just ignoring everything in that file when
checking cross-references.  In contrast, xsltproc is quite happy to
handle these cross-references and generates links for them in the HTML
output.

  Daniel

-- System Information:
Debian Release: lenny/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'stable')
Architecture: i386 (i686)

Kernel: Linux 2.6.25-2-686 (SMP w/1 CPU core)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8) (ignored: LC_ALL set to en_US.UTF-8)
Shell: /bin/sh linked to /bin/bash

Versions of packages xmlto depends on:
ii  debianutils              2.28.6          Miscellaneous utilities specific t
ii  docbook-xml              4.5-5           standard XML documentation system,
ii  docbook-xsl              1.73.2.dfsg.1-4 stylesheets for processing DocBook
ii  libc6                    2.7-11          GNU C Library: Shared libraries
ii  libxml2-utils            2.6.32.dfsg-2   XML utilities
ii  sgml-base                1.26            SGML infrastructure and SGML catal
ii  xsltproc                 1.1.24-1        XSLT command line processor

Versions of packages xmlto recommends:
ii  libpaper-utils                1.1.23     library for handling paper charact

-- no debconf information