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--