[debiandoc-sgml-pkgs] Bug#126438: nested <file> <url> ...

[Osamu Aoki]

severity 126438 minor
thanks

Hi,

I am moving this to severity minor since this is not going to affect use
of debiandoc-sgml in any significant way.

First if you are looking for a good way to display file reference in
fixed width fonts, it is best done by just simply using <url id=3D"...">
without name tag.  <file> tag was not meant to be nested with <url> to
make displayed text to be fixed width.  <file> tag should contain file
location itself in text.

I have tested:
--------------
<!doctype debiandoc system [
]>
<debiandoc>
  <book>
      <title>Foo</title>
      <author>
	<name>Frank K=FCster</name>
	<email>frank@debian.org</email>
      </author>
     <chapt>=20
       <heading>Foo</heading>=20
       <p>=20
 	  file and url id+name: <file><url id=3D"file:///usr/share/common-license=
s/GPL"=20
 	  name=3D"/usr/share/common-licenses/GPL"></file> in the Debian=20
       </p>
       <p>=20
 	  tt and url id+name: <tt><url id=3D"file:///usr/share/common-licenses/GP=
L"=20
 	  name=3D"/usr/share/common-licenses/GPL"></tt> in the Debian=20
       </p>
       <p>
	  url id+name: <url id=3D"file:///usr/share/common-licenses/GPL"
	  name=3D"/usr/share/common-licenses/GPL"> in the Debian
       </p>=20
       <p>
	  url id: <url id=3D"file:///usr/share/common-licenses/GPL"
	  > in the Debian
       </p>=20
     </chapt>
  </book>
</debiandoc>
--------------
and got
---------------
file and url id+name:    /usr/share/common-licenses/GPL (file:///usr/share/=
common-licenses/GPL) in the Debian

tt and url id+name: /usr/share/common-licenses/GPL (file:///usr/share/commo=
n-licenses/GPL) in the Debian

url id+name: /usr/share/common-licenses/GPL (file:///usr/share/common-licen=
ses/GPL) in the Debian

url id: file:///usr/share/common-licenses/GPL in the Debia
--------------
All but first link works in xpdf.  Fist on has funny spaces which makes
link to fail.
--------------
file / / / /usr /share /common-licenses /GPL
--------------

So if you need fixed text which is not file reference (id<>name), then
use <tt>.  This will work as functioning workaround.

I also agree this is not a bug in te-tex with the information provided.

I am sure changing <file> tag behavior in line with <tt>, we should be
able to fix this issue in debiandoc-sgml.  But this is too large a
change for me to do now for minor cosmetic improvement for a bug with
working workaround.  Thus putting this into minor category and leaving
it as is.

If we get good patch with test results, we will be happy to fix this.

Regards,

Osamu


--=20
~\^o^/~~~ ~\^.^/~~~ ~\^*^/~~~ ~\^_^/~~~ ~\^+^/~~~ ~\^:^/~~~ ~\^v^/~~~ +++++
        Osamu Aoki <osamu@debian.org>  Brussels Belgium, GPG-key: A8061F32
 .''`.  Debian Reference: post-installation user's guide for non-developers
 : :' : http://qref.sf.net and http://people.debian.org/~osamu
 `. `'  "Our Priorities are Our Users and Free Software" --- Social Contract