Some cosmetic tweaks to get rid of empty synopses, empty function groups, and use more nested directories

[SVN r33018]
This commit is contained in:
Douglas Gregor 2006-02-20 03:09:03 +00:00
parent f2e3909666
commit 24621811da
5 changed files with 68 additions and 49 deletions

View File

@ -20,7 +20,10 @@
<xsl:choose> <xsl:choose>
<xsl:when test="count(key('named-entities', $name))=1 <xsl:when test="count(key('named-entities', $name))=1
and ($translated-name=$name)"> and ($translated-name=$name)">
<xsl:value-of select="$name"/> <xsl:call-template name="fully-qualified-name">
<xsl:with-param name="node" select="."/>
<xsl:with-param name="separator" select="'.'"/>
</xsl:call-template>
</xsl:when> </xsl:when>
<xsl:otherwise> <xsl:otherwise>
<xsl:value-of select="generate-id(.)"/> <xsl:value-of select="generate-id(.)"/>

View File

@ -112,11 +112,12 @@
</xsl:call-template> </xsl:call-template>
</xsl:if> </xsl:if>
<xsl:if test="namespace|class|struct|union"> <xsl:if test="descendant::class|descendant::struct|descendant::union
|descendant::function|descendant::free-function-group">
<xsl:call-template name="synopsis"> <xsl:call-template name="synopsis">
<xsl:with-param name="text"> <xsl:with-param name="text">
<xsl:apply-templates mode="synopsis" <xsl:apply-templates mode="synopsis"
select="namespace|class|struct|union"> select="namespace|class|struct|union|function|free-function-group">
<xsl:with-param name="indentation" select="0"/> <xsl:with-param name="indentation" select="0"/>
</xsl:apply-templates> </xsl:apply-templates>
</xsl:with-param> </xsl:with-param>

View File

@ -579,12 +579,20 @@ Cannot handle compounddef with kind=<xsl:value-of select="@kind"/>
</method-group> </method-group>
</xsl:when> </xsl:when>
<xsl:when test="@kind='public-func'"> <xsl:when test="@kind='public-func'">
<method-group name="public member functions"> <xsl:variable name="members" select="./memberdef"/>
<xsl:apply-templates> <xsl:variable name="num-internal-only">
<xsl:with-param name="in-section" select="true()"/> <xsl:value-of
</xsl:apply-templates> select="count($members[contains(detaileddescription/para,
</method-group> 'INTERNAL ONLY')])"/>
<xsl:apply-templates/> </xsl:variable>
<xsl:if test="$num-internal-only &lt; count($members)">
<method-group name="public member functions">
<xsl:apply-templates>
<xsl:with-param name="in-section" select="true()"/>
</xsl:apply-templates>
</method-group>
<xsl:apply-templates/>
</xsl:if>
</xsl:when> </xsl:when>
<xsl:when test="@kind='protected-func'"> <xsl:when test="@kind='protected-func'">
<method-group name="protected member functions"> <method-group name="protected member functions">

View File

@ -1103,50 +1103,54 @@
<!-- Group member functions together under a category name (synopsis)--> <!-- Group member functions together under a category name (synopsis)-->
<xsl:template match="method-group" mode="synopsis"> <xsl:template match="method-group" mode="synopsis">
<xsl:param name="indentation"/> <xsl:if test="count(child::*) &gt; 0">
<xsl:text>&#10;</xsl:text> <xsl:param name="indentation"/>
<xsl:text>&#10;</xsl:text> <xsl:text>&#10;</xsl:text>
<xsl:call-template name="indent"> <xsl:text>&#10;</xsl:text>
<xsl:with-param name="indentation" select="$indentation"/> <xsl:call-template name="indent">
</xsl:call-template> <xsl:with-param name="indentation" select="$indentation"/>
<emphasis>
<xsl:text>// </xsl:text>
<xsl:call-template name="internal-link">
<xsl:with-param name="to">
<xsl:call-template name="generate.id"/>
</xsl:with-param>
<xsl:with-param name="text" select="string(@name)"/>
</xsl:call-template> </xsl:call-template>
</emphasis> <emphasis>
<xsl:apply-templates select="method|overloaded-method" <xsl:text>// </xsl:text>
mode="synopsis"> <xsl:call-template name="internal-link">
<xsl:with-param name="indentation" select="$indentation"/> <xsl:with-param name="to">
</xsl:apply-templates> <xsl:call-template name="generate.id"/>
</xsl:with-param>
<xsl:with-param name="text" select="string(@name)"/>
</xsl:call-template>
</emphasis>
<xsl:apply-templates select="method|overloaded-method"
mode="synopsis">
<xsl:with-param name="indentation" select="$indentation"/>
</xsl:apply-templates>
</xsl:if>
</xsl:template> </xsl:template>
<!-- Group member functions together under a category name (reference)--> <!-- Group member functions together under a category name (reference)-->
<xsl:template match="method-group" mode="reference"> <xsl:template match="method-group" mode="reference">
<xsl:call-template name="member-documentation"> <xsl:if test="count(child::*) &gt; 0">
<xsl:with-param name="name"> <xsl:call-template name="member-documentation">
<xsl:call-template name="anchor"> <xsl:with-param name="name">
<xsl:with-param name="to"> <xsl:call-template name="anchor">
<xsl:call-template name="generate.id"/> <xsl:with-param name="to">
</xsl:with-param> <xsl:call-template name="generate.id"/>
<xsl:with-param name="text" select="''"/> </xsl:with-param>
</xsl:call-template> <xsl:with-param name="text" select="''"/>
<xsl:call-template name="monospaced"> </xsl:call-template>
<xsl:with-param name="text" select="../@name"/> <xsl:call-template name="monospaced">
</xsl:call-template> <xsl:with-param name="text" select="../@name"/>
<xsl:text> </xsl:text> </xsl:call-template>
<xsl:value-of select="@name"/> <xsl:text> </xsl:text>
</xsl:with-param> <xsl:value-of select="@name"/>
<xsl:with-param name="text"> </xsl:with-param>
<orderedlist> <xsl:with-param name="text">
<xsl:apply-templates select="method|overloaded-method" <orderedlist>
mode="reference"/> <xsl:apply-templates select="method|overloaded-method"
</orderedlist> mode="reference"/>
</xsl:with-param> </orderedlist>
</xsl:call-template> </xsl:with-param>
</xsl:call-template>
</xsl:if>
</xsl:template> </xsl:template>
<!-- Group free functions together under a category name (synopsis)--> <!-- Group free functions together under a category name (synopsis)-->

View File

@ -61,6 +61,9 @@
<xsl:text>;</xsl:text> <xsl:text>;</xsl:text>
</xsl:template> </xsl:template>
<xsl:template match="data-member" mode="generate.id"> <xsl:template match="data-member" mode="generate.id">
<xsl:value-of select="@name" /> <xsl:call-template name="fully-qualified-name">
<xsl:with-param name="node" select="."/>
<xsl:with-param name="separator" select="'.'"/>
</xsl:call-template>
</xsl:template> </xsl:template>
</xsl:stylesheet> </xsl:stylesheet>