Re: [Boost-docs] [boostbook][patch]remove spurious paragraph in overloaded method descriptions

Subject: Re: [Boost-docs] [boostbook][patch]remove spurious paragraph in overloaded method descriptions
From: Frank Mori Hess (frank.hess_at_[hidden])
Date: 2007-10-30 21:07:15


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On Tuesday 30 October 2007 16:52 pm, you wrote:
> On Monday 29 October 2007 16:53 pm, Daniel James wrote:
> >
> > Is there any reason why the patch moves the anchor to the end of the
> > function declarations? I think it should be at the start so that a link
> > to the overloaded methods will show all the methods.
>
> Only that moving it from before the declarations to after them prevented a
> spurious paragraph from appearing in the html output. I'll try playing
> around with it a bit more and see if I can avoid having the anchor at the
> end. At the very least, I can probably move the anchor inside the
> <xsl:for-each> so it appears at the end of the first overload declaration.

Well, that was easy. Apparently, as long as the anchor is inside the
preformatted section, no spurious paragraph is generated. I must have
tricked myself into some wrong thinking the first time around. Here's a
revised patch.

- --
Frank
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)

iD8DBQFHJ50G5vihyNWuA4URAgISAKDjAABN9AsMtpc0EgBNo5wEg8CnvwCfW87h
boqPvP+HzaqQSIjpm2XX1wQ=
=t/zf
-----END PGP SIGNATURE-----

--Boundary-00=_G05JHfO+uh33Oer
Content-Type: text/x-diff; charset="iso-8859-1";
        name="overloaded_method_extra_paragraph2.patch"
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment;
        filename="overloaded_method_extra_paragraph2.patch"

Index: tools/boostbook/xsl/function.xsl
===================================================================
--- tools/boostbook/xsl/function.xsl (revision 40555)
+++ tools/boostbook/xsl/function.xsl (working copy)
@@ -995,12 +995,13 @@
     <xsl:call-template name="function.documentation">
       <xsl:with-param name="text">
         <para>
- <xsl:attribute name="id">
- <xsl:call-template name="generate.id"/>
- </xsl:attribute>
-
           <xsl:call-template name="preformatted">
             <xsl:with-param name="text">
+ <xsl:call-template name="anchor">
+ <xsl:with-param name="to">
+ <xsl:call-template name="generate.id"/>
+ </xsl:with-param>
+ </xsl:call-template>
               <xsl:for-each select="signature">
                 <xsl:call-template name="function">
                   <xsl:with-param name="indentation" select="0"/>

--Boundary-00=_G05JHfO+uh33Oer--


This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:40 UTC