Bug#528849: refentry.xsl: on the n-dash use and the @refclass handling

[Ivan Shmakov]

Package: dblatex
Version: 0.2.9-3
Severity: minor

        There're a couple of minor flaws in the formatting as being done
        by refentry.xsl.  Namely, the code reads:

$ nl -ba /usr/share/xml/docbook/stylesheet/dblatex/xsl/refentry.xsl 
...
   183  <xsl:template match="refpurpose">
   184    <xsl:text> -- </xsl:text>
   185    <xsl:apply-templates/>
   186  </xsl:template>

        In the template above, ``--'', which is LaTeX for n-dash, is
        used to separate the reference name from it's ``purpose'', while
        I'd expect an m-dash to be used here (either ``---'', or,
        perhaps preferrably if possible, ``&mdash;'' or ``&#x2014;''.)

   187  
   188  <xsl:template match="refdescriptor">
   189    <xsl:apply-templates/>
   190  </xsl:template>
   191  
   192  <xsl:template match="refclass">
   193    <xsl:if test="@role">
   194      <xsl:value-of select="@role"/>
   195      <xsl:text>: </xsl:text>
   196    </xsl:if>
   197    <xsl:apply-templates/>

        Here, the value of the ``refclass'' attribute is put (along with
        a role, if one's used) is output on the very same line as is the
        ``refname'', without any separating whitespace or other
        formatting.

   198  </xsl:template>
...
$ 

        Please consider the following example:

<?xml version="1.0" encoding="us-ascii" standalone="no"?>
<!DOCTYPE article
          PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
          "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd";>
<article xml:lang="en" lang="en">
  <refentry>
    <refmeta>
      <refentrytitle>foo</refentrytitle>
      <manvolnum>1</manvolnum>
    </refmeta>
    <refnamediv>
      <refname>foo</refname>
      <refpurpose>tweak bar</refpurpose>
      <refclass><application>Qux</application></refclass>
    </refnamediv>
    <refsynopsisdiv>
      <cmdsynopsis>
        <command>foo</command>
      </cmdsynopsis>
    </refsynopsisdiv>
  </refentry>
</article>

        Which is converted to the following LaTeX code:

...
% Refentry 
% ---------

\section{foo}

\subsection*{Name}
foo -- tweak barQux
\subsection*{Synopsis}

\texttt{f\-o\-o} 
...

        While I'd expect something like:

foo --- tweak bar\\
Qux

        instead.

        Please note that the docbook-xsl (as of 1.73.2.dfsg.1-5)
        apparently formats this fragment just fine, e. g.:

...
      <div class="refentry" lang="en" xml:lang="en">
        <a id="id376529" shape="rect"/>
        <div class="titlepage"/>
        <div class="refnamediv">
          <h2>Name</h2>
          <p>foo &#8212; tweak bar<p><b><span class="application"
>Qux</span></b></p></p>
        </div>
...

        (Where &#8212; is an m-dash.)

-- 
FSF associate member #7257



-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org