Bug#126438: pdflatex: nested tags and relative links

[Frank Küster <frank@debian.org>]

reassign 126438 debiandoc-sgml
thanks

Hi Ardo, Chris, Hille,

this seems to be a bug in debiandoc-sgml:

Hilmar Preusse <hille42@web.de> wrote:

> On 25.12.01 Chris Tillman (toff@azstarnet.com) wrote:
>
> Hi,
>
> are you same one, who submitted http://bugs.debian.org/126438 a long
> time ago?
>
>> I noticed whenever a url link is nested inside a <file> tag, the
>> pdflatex output is incorrect and unlinked. If that can't be fixed,
>> a suggested workaround would be to have nsgmls generate an error or
>> warning.
>> 
> Are you still interested in fixing that bug and willing to help us?
>   If yes: would you be so kind to give a minimal example, which shows
> that behaviour? The <file>-Tag has nothing to do with TeX, has it?

If you'd have worked with debiandoc before, you'd probably have noticed
from his small hints that he is working with that. At least my magic
crystal ball said this, and I could reproduce the bug:


<!doctype debiandoc system [
]>
<debiandoc>
  <book>
      <title>Foo</title>
      <author>
	<name>Frank Küster</name>
	<email>frank@debian.org</email>
      </author>
     <chapt> 
       <heading>Foo</heading> 
       <p> 
	  A copy of the GNU General Public License is available as

<!-- 	  <file><url id="file:///usr/share/common-licenses/GPL" -->
<!-- 	  name="/usr/share/common-licenses/GPL"></file> in the Debian -->

	  <url id="file:///usr/share/common-licenses/GPL"
	  name="/usr/share/common-licenses/GPL"> in the Debian
       </p> 
     </chapt>
  </book>
</debiandoc>

This document is processed well, but if you use the commented two lines
instead of the following two, you get the following differences:

- the filename is typeset in typewriter font, as is intended

- the link is not correct, it points to 

file:%20/%20/%20/usr%20/share%20/common-licenses%20/GPL

(the %20 signs are printed in the location bar, the error message
indicates that they are interpreted as space).

I guess the proper solution would be to print the non-active text part
of an url, i.e. the `name="..."', in a typewriter font, or make it
configurable via <url id="..." name="..." font=typewriter>.

>> Also, relative links which work fine when using debiandoc2html are
>> broken in the pdf format. If you click on one of these links,
>> acrobat reports a relative link not found error. 

This works now - e.g. the first chapter of the developer's reference
starts with 

,----
|     <chapt id="scope">Scope of This Document
|       <p>
| The purpose of this document is to provide an overview of the
| recommended procedures and the available resources for Debian
| developers.
| 
| <!-- FIXME: rewrites -->
|       <p>
| The procedures discussed within include how to become a maintainer
| (<ref id="new-maintainer">); how to create new packages
`----

and the link works fine (at least in xpdf).

Regards, Frank
-- 
Frank Küster
Inst. f. Biochemie der Univ. Zürich
Debian Developer