[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: refentry "source" versus "source-info"?
common/refentry.xsl has a reference to "source-name":
<doc:template name="get.refentry.source.name" xmlns="">
<refpurpose>Gets source-name metadata for a refentry</refpurpose>
<refdescription>
<para>A "source name" is one part of a (potentially) two-part
<replaceable>Name</replaceable> <replaceable>Version</replaceable>
source field. For more details, see the documentation for the
<function>get.refentry.source</function> template.</para>
</refdescription>
...
But then later down the code uses "source":
<xsl:template name="get.refentry.source.name">
...
<xsl:choose>
<xsl:when test="refmeta/refmiscinfo[@class = 'source']">
<xsl:apply-templates
select="refmeta/refmiscinfo[@class = 'source'][1]/node()"/>
</xsl:when>
<!-- * no <refmisc class="source"/> found, so we need to -->
<!-- * check *info and parentinfo -->
The 1.69.0 part of the release notes file (man section) also
uses "source-name", in an example:
The easiest way to control the contents of those fields is to mark up
your
refentry content like the following (note that this is a "minimal"
example).
<refentry>
<info>
<date>2003-10-20</date> 1
</info>
<refmeta>
<refentrytitle>gtk-options</refentrytitle> 2
<manvolnum>7</manvolnum> 3
<refmiscinfo class="source-name">GTK+</refmiscinfo> 4
<refmiscinfo class="version">1.2</refmiscinfo> 5
<refmiscinfo class="manual">GTK+ User's Manual</refmiscinfo> 6
</refmeta>
<refnamediv>
<refname>gtk-options</refname>
<refpurpose>Standard Command Line Options for GTK+
Programs</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<para>This manual page describes the command line options, which
are common to all GTK+ based applications.</para>
</refsect1>
</refentry>
It looks to me that if you actually use class="source-name" as the
example suggests, the template in common/refentry.xsl will miss it?
Is there an inconsistency here regarding "source" versus "source-name"?
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]