Package: docbook-xsl
Version: 1.68.1-0.1

  If I nest a replaceable tag inside a filename tag in a manpage, it appears
that the XSL stylesheets generate a "start italic" tag for each of the two
start tags, and an "end italic" for each of the two end tags.  Since troff
doesn't have a stack of styles, this results in the italic text being
terminated too soon, like this:

[start italics]/non/replaceable/stuff<foo>[end italics]/more/non/replaceable

  More concretely, the last section of aptitude's manpage (in SVN) is:

  <refsect1>
    <title>See Also</title>

    <para>
      
<citerefentry><refentrytitle>apt-get</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 
<citerefentry><refentrytitle>apt</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 
<filename>/usr/share/doc/aptitude/<replaceable>lang</replaceable>/html/index.html</filename>
 
from the package aptitude-doc-<replaceable>lang</replaceable>
    </para>
  </refsect1>

  In the generated manpage, this renders as follows:

.SH "SEE ALSO"

.PP
 \fBapt\-get\fR(8), \fBapt\fR(8), 
\fI/usr/share/doc/aptitude/\fI<lang>\fR/html/index\&.html\fR from the package 
aptitude\-doc\-\fI<lang>\fR

  Here \fI<lang>\fR should be just <lang>, since the surrounding text is 
already italic.

  Daniel

-- System Information:
Debian Release: testing/unstable
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'testing'), (1, 'experimental')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.12-1-686
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)

-- 
/------------------- Daniel Burrows <[EMAIL PROTECTED]> ------------------\
|              Hi, I'm a .signature virus!                                  |
|              Copy me into your .signature to help me spread!              |
\---------------- The Turtle Moves! -- http://www.lspace.org ---------------/

Attachment: pgp0rJdQWqWmJ.pgp
Description: PGP signature

Reply via email to