doc/help/xslt/html/synop.xsl

   1 <?xml version='1.0'?>
   2 <!DOCTYPE xsl:stylesheet [
   3 <!ENTITY nbsp "&#160;">
   4 ]>
   5 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
   6                 version='1.0'>
   7
   8 <!-- ********************************************************************
   9      $Id: synop.xsl 8421 2009-05-04 07:49:49Z bobstayton $
  10      ********************************************************************
  11
  12      This file is part of the XSL DocBook Stylesheet distribution.
  13      See ../README or http://docbook.sf.net/release/xsl/current/ for
  14      copyright and other information.
  15
  16      ******************************************************************** -->
  17
  18 <!-- ==================================================================== -->
  19
  20 <!-- synopsis is in verbatim -->
  21
  22 <!-- ==================================================================== -->
  23
  24 <xsl:template match="cmdsynopsis">
  25   <div>
  26     <xsl:apply-templates select="." mode="common.html.attributes"/>
  27     <p>
  28       <xsl:if test="..//processing-instruction('dbcmdlist')">
  29         <!-- * Placing a dbcmdlist PI as a child of a particular element -->
  30         <!-- * creates a hyperlinked list of all cmdsynopsis instances -->
  31         <!-- * that are descendants of that element; so for any -->
  32         <!-- * cmdsynopsis that is a descendant of an element containing -->
  33         <!-- * a dbcmdlist PI, we need to output an a@id instance so that -->
  34         <!-- * we will have something to link to -->
  35         <xsl:call-template name="anchor">
  36           <xsl:with-param name="conditional" select="0"/>
  37         </xsl:call-template>
  38       </xsl:if>
  39       <xsl:apply-templates/>
  40     </p>
  41   </div>
  42 </xsl:template>
  43
  44 <xsl:template match="cmdsynopsis/command">
  45   <br/>
  46   <xsl:call-template name="inline.monoseq"/>
  47   <xsl:text> </xsl:text>
  48 </xsl:template>
  49
  50 <xsl:template match="cmdsynopsis/command[1]" priority="2">
  51   <xsl:call-template name="inline.monoseq"/>
  52   <xsl:text> </xsl:text>
  53 </xsl:template>
  54
  55 <xsl:template match="group|arg" name="group-or-arg">
  56   <xsl:variable name="choice" select="@choice"/>
  57   <xsl:variable name="rep" select="@rep"/>
  58   <xsl:variable name="sepchar">
  59     <xsl:choose>
  60       <xsl:when test="ancestor-or-self::*/@sepchar">
  61         <xsl:value-of select="ancestor-or-self::*/@sepchar"/>
  62       </xsl:when>
  63       <xsl:otherwise>
  64         <xsl:text> </xsl:text>
  65       </xsl:otherwise>
  66     </xsl:choose>
  67   </xsl:variable>
  68
  69   <xsl:if test="preceding-sibling::*">
  70     <xsl:value-of select="$sepchar"/>
  71   </xsl:if>
  72   <xsl:choose>
  73     <xsl:when test="$choice='plain'">
  74       <xsl:value-of select="$arg.choice.plain.open.str"/>
  75     </xsl:when>
  76     <xsl:when test="$choice='req'">
  77       <xsl:value-of select="$arg.choice.req.open.str"/>
  78     </xsl:when>
  79     <xsl:when test="$choice='opt'">
  80       <xsl:value-of select="$arg.choice.opt.open.str"/>
  81     </xsl:when>
  82     <xsl:otherwise>
  83       <xsl:value-of select="$arg.choice.def.open.str"/>
  84     </xsl:otherwise>
  85   </xsl:choose>
  86   <xsl:apply-templates/>
  87   <xsl:choose>
  88     <xsl:when test="$rep='repeat'">
  89       <xsl:value-of select="$arg.rep.repeat.str"/>
  90     </xsl:when>
  91     <xsl:when test="$rep='norepeat'">
  92       <xsl:value-of select="$arg.rep.norepeat.str"/>
  93     </xsl:when>
  94     <xsl:otherwise>
  95       <xsl:value-of select="$arg.rep.def.str"/>
  96     </xsl:otherwise>
  97   </xsl:choose>
  98   <xsl:choose>
  99     <xsl:when test="$choice='plain'">
 100       <xsl:value-of select="$arg.choice.plain.close.str"/>
 101     </xsl:when>
 102     <xsl:when test="$choice='req'">
 103       <xsl:value-of select="$arg.choice.req.close.str"/>
 104     </xsl:when>
 105     <xsl:when test="$choice='opt'">
 106       <xsl:value-of select="$arg.choice.opt.close.str"/>
 107     </xsl:when>
 108     <xsl:otherwise>
 109       <xsl:value-of select="$arg.choice.def.close.str"/>
 110     </xsl:otherwise>
 111   </xsl:choose>
 112 </xsl:template>
 113
 114 <xsl:template match="group/arg">
 115   <xsl:variable name="choice" select="@choice"/>
 116   <xsl:variable name="rep" select="@rep"/>
 117   <xsl:if test="preceding-sibling::*">
 118     <xsl:value-of select="$arg.or.sep"/>
 119   </xsl:if>
 120   <xsl:call-template name="group-or-arg"/>
 121 </xsl:template>
 122
 123 <xsl:template match="sbr">
 124   <br/>
 125 </xsl:template>
 126
 127 <!-- ==================================================================== -->
 128
 129 <xsl:template match="synopfragmentref">
 130   <xsl:variable name="target" select="key('id',@linkend)"/>
 131   <xsl:variable name="snum">
 132     <xsl:apply-templates select="$target" mode="synopfragment.number"/>
 133   </xsl:variable>
 134   <i>
 135     <a href="#{@linkend}">
 136       <xsl:text>(</xsl:text>
 137       <xsl:value-of select="$snum"/>
 138       <xsl:text>)</xsl:text>
 139     </a>
 140     <xsl:text>&#160;</xsl:text>
 141     <xsl:apply-templates/>
 142   </i>
 143 </xsl:template>
 144
 145 <xsl:template match="synopfragment" mode="synopfragment.number">
 146   <xsl:number format="1"/>
 147 </xsl:template>
 148
 149 <xsl:template match="synopfragment">
 150   <xsl:variable name="snum">
 151     <xsl:apply-templates select="." mode="synopfragment.number"/>
 152   </xsl:variable>
 153   <!-- You can't introduce another <p> here, because you're
 154        already in a <p> from cmdsynopsis-->
 155   <span>
 156     <xsl:variable name="id">
 157       <xsl:call-template name="object.id"/>
 158     </xsl:variable>
 159     <a name="{$id}">
 160       <xsl:text>(</xsl:text>
 161       <xsl:value-of select="$snum"/>
 162       <xsl:text>)</xsl:text>
 163     </a>
 164     <xsl:text> </xsl:text>
 165     <xsl:apply-templates/>
 166   </span>
 167 </xsl:template>
 168
 169 <xsl:template match="funcsynopsis">
 170   <xsl:if test="..//processing-instruction('dbfunclist')">
 171     <!-- * Placing a dbfunclist PI as a child of a particular element -->
 172     <!-- * creates a hyperlinked list of all funcsynopsis instances that -->
 173     <!-- * are descendants of that element; so for any funcsynopsis that is -->
 174     <!-- * a descendant of an element containing a dbfunclist PI, we need -->
 175     <!-- * to output an a@id instance so that we will have something to -->
 176     <!-- * link to -->
 177     <xsl:call-template name="anchor">
 178       <xsl:with-param name="conditional" select="0"/>
 179     </xsl:call-template>
 180   </xsl:if>
 181   <xsl:call-template name="informal.object"/>
 182 </xsl:template>
 183
 184 <xsl:template match="funcsynopsisinfo">
 185   <pre>
 186     <xsl:apply-templates select="." mode="common.html.attributes"/>
 187     <xsl:apply-templates/>
 188   </pre>
 189 </xsl:template>
 190
 191 <!-- ====================================================================== -->
 192 <!-- funcprototype -->
 193 <!--
 194
 195 funcprototype ::= (funcdef,
 196                    (void|varargs|paramdef+))
 197
 198 funcdef       ::= (#PCDATA|type|replaceable|function)*
 199
 200 paramdef      ::= (#PCDATA|type|replaceable|parameter|funcparams)*
 201 -->
 202
 203 <xsl:template match="funcprototype">
 204   <xsl:variable name="html-style">
 205     <xsl:call-template name="pi.dbhtml_funcsynopsis-style">
 206       <xsl:with-param name="node" select="ancestor::funcsynopsis/descendant-or-self::*"/>
 207     </xsl:call-template>
 208   </xsl:variable>
 209
 210   <xsl:variable name="style">
 211     <xsl:choose>
 212       <xsl:when test="$html-style != ''">
 213         <xsl:value-of select="$html-style"/>
 214       </xsl:when>
 215       <xsl:otherwise>
 216         <xsl:value-of select="$funcsynopsis.style"/>
 217       </xsl:otherwise>
 218     </xsl:choose>
 219   </xsl:variable>
 220
 221 <!-- * 2008-02-17. the code no longer relies on the funcsynopsis.tabular.threshold -->
 222 <!-- * param at all (the stuff below has been commented out since mid -->
 223 <!-- * 2006), so I completely removed the funcsynopsis.tabular.threshold param -->
 224 <!-- * .. MikeSmith -->
 225 <!--
 226   <xsl:variable name="tabular-p"
 227                 select="$funcsynopsis.tabular.threshold &gt; 0
 228                         and string-length(.) &gt; $funcsynopsis.tabular.threshold"/>
 229 -->
 230
 231   <xsl:variable name="tabular-p" select="true()"/>
 232
 233   <xsl:choose>
 234     <xsl:when test="$style = 'kr' and $tabular-p">
 235       <xsl:apply-templates select="." mode="kr-tabular"/>
 236     </xsl:when>
 237     <xsl:when test="$style = 'kr'">
 238       <xsl:apply-templates select="." mode="kr-nontabular"/>
 239     </xsl:when>
 240     <xsl:when test="$style = 'ansi' and $tabular-p">
 241       <xsl:apply-templates select="." mode="ansi-tabular"/>
 242     </xsl:when>
 243     <xsl:otherwise>
 244       <xsl:apply-templates select="." mode="ansi-nontabular"/>
 245     </xsl:otherwise>
 246   </xsl:choose>
 247 </xsl:template>
 248
 249 <!-- ====================================================================== -->
 250 <!-- funcprototype: kr, non-tabular -->
 251
 252 <xsl:template match="funcprototype" mode="kr-nontabular">
 253   <p>
 254     <xsl:apply-templates mode="kr-nontabular"/>
 255     <xsl:if test="paramdef">
 256       <br/>
 257       <xsl:apply-templates select="paramdef" mode="kr-funcsynopsis-mode"/>
 258     </xsl:if>
 259   </p>
 260 </xsl:template>
 261
 262 <xsl:template match="funcdef" mode="kr-nontabular">
 263   <code>
 264     <xsl:apply-templates select="." mode="common.html.attributes"/>
 265     <xsl:apply-templates mode="kr-nontabular"/>
 266     <xsl:text>(</xsl:text>
 267   </code>
 268 </xsl:template>
 269
 270 <xsl:template match="funcdef/function" mode="kr-nontabular">
 271   <xsl:choose>
 272     <xsl:when test="$funcsynopsis.decoration != 0">
 273       <b class="fsfunc"><xsl:apply-templates mode="kr-nontabular"/></b>
 274     </xsl:when>
 275     <xsl:otherwise>
 276       <xsl:apply-templates mode="kr-nontabular"/>
 277     </xsl:otherwise>
 278   </xsl:choose>
 279 </xsl:template>
 280
 281 <xsl:template match="void" mode="kr-nontabular">
 282   <code>)</code>
 283   <xsl:text>;</xsl:text>
 284 </xsl:template>
 285
 286 <xsl:template match="varargs" mode="kr-nontabular">
 287   <xsl:text>...</xsl:text>
 288   <code>)</code>
 289   <xsl:text>;</xsl:text>
 290 </xsl:template>
 291
 292 <xsl:template match="paramdef" mode="kr-nontabular">
 293   <xsl:apply-templates select="parameter" mode="kr-nontabular"/>
 294   <xsl:choose>
 295     <xsl:when test="following-sibling::*">
 296       <xsl:text>, </xsl:text>
 297     </xsl:when>
 298     <xsl:otherwise>
 299       <code>)</code>
 300       <xsl:text>;</xsl:text>
 301     </xsl:otherwise>
 302   </xsl:choose>
 303 </xsl:template>
 304
 305 <xsl:template match="paramdef/parameter" mode="kr-nontabular">
 306   <xsl:choose>
 307     <xsl:when test="$funcsynopsis.decoration != 0">
 308       <var class="pdparam">
 309         <xsl:apply-templates mode="kr-nontabular"/>
 310       </var>
 311     </xsl:when>
 312     <xsl:otherwise>
 313       <code>
 314         <xsl:apply-templates mode="kr-nontabular"/>
 315       </code>
 316     </xsl:otherwise>
 317   </xsl:choose>
 318 </xsl:template>
 319
 320 <xsl:template match="paramdef" mode="kr-funcsynopsis-mode">
 321   <xsl:if test="preceding-sibling::paramdef"><br/></xsl:if>
 322   <code>
 323     <xsl:apply-templates mode="kr-funcsynopsis-mode"/>
 324   </code>
 325   <xsl:text>;</xsl:text>
 326 </xsl:template>
 327
 328 <xsl:template match="paramdef/parameter" mode="kr-funcsynopsis-mode">
 329   <xsl:choose>
 330     <xsl:when test="$funcsynopsis.decoration != 0">
 331       <var class="pdparam">
 332         <xsl:apply-templates mode="kr-funcsynopsis-mode"/>
 333       </var>
 334     </xsl:when>
 335     <xsl:otherwise>
 336       <code>
 337         <xsl:apply-templates mode="kr-funcsynopsis-mode"/>
 338       </code>
 339     </xsl:otherwise>
 340   </xsl:choose>
 341 </xsl:template>
 342
 343 <xsl:template match="funcparams" mode="kr-funcsynopsis-mode">
 344   <code>(</code>
 345   <xsl:apply-templates mode="kr-funcsynopsis-mode"/>
 346   <code>)</code>
 347 </xsl:template>
 348
 349 <!-- ====================================================================== -->
 350 <!-- funcprototype: kr, tabular -->
 351
 352 <xsl:template match="funcprototype" mode="kr-tabular">
 353   <table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"
 354     class="funcprototype-table"
 355     >
 356     <tr>
 357       <td>
 358         <xsl:apply-templates select="funcdef" mode="kr-tabular"/>
 359       </td>
 360       <xsl:apply-templates select="(void|varargs|paramdef)[1]" mode="kr-tabular"/>
 361     </tr>
 362     <xsl:for-each select="(void|varargs|paramdef)[preceding-sibling::*[not(self::funcdef)]]">
 363       <tr>
 364         <td>&#160;</td>
 365         <xsl:apply-templates select="." mode="kr-tabular"/>
 366       </tr>
 367     </xsl:for-each>
 368   </table>
 369   <xsl:if test="paramdef">
 370     <div class="paramdef-list">
 371       <xsl:apply-templates select="paramdef" mode="kr-funcsynopsis-mode"/>
 372     </div>
 373   </xsl:if>
 374   <div class="funcprototype-spacer">&#160;</div> <!-- hACk: blank div for vertical spacing -->
 375 </xsl:template>
 376
 377 <xsl:template match="funcdef" mode="kr-tabular">
 378   <code>
 379     <xsl:apply-templates select="." mode="common.html.attributes"/>
 380     <xsl:apply-templates mode="kr-tabular"/>
 381     <xsl:text>(</xsl:text>
 382   </code>
 383 </xsl:template>
 384
 385 <xsl:template match="funcdef/function" mode="kr-tabular">
 386   <xsl:choose>
 387     <xsl:when test="$funcsynopsis.decoration != 0">
 388       <b class="fsfunc"><xsl:apply-templates mode="kr-nontabular"/></b>
 389     </xsl:when>
 390     <xsl:otherwise>
 391       <xsl:apply-templates mode="kr-tabular"/>
 392     </xsl:otherwise>
 393   </xsl:choose>
 394 </xsl:template>
 395
 396 <xsl:template match="void" mode="kr-tabular">
 397   <td>
 398     <code>)</code>
 399     <xsl:text>;</xsl:text>
 400   </td>
 401   <td>&#160;</td>
 402 </xsl:template>
 403
 404 <xsl:template match="varargs" mode="kr-tabular">
 405   <td>
 406     <xsl:text>...</xsl:text>
 407     <code>)</code>
 408     <xsl:text>;</xsl:text>
 409   </td>
 410   <td>&#160;</td>
 411 </xsl:template>
 412
 413 <xsl:template match="paramdef" mode="kr-tabular">
 414   <td>
 415     <xsl:apply-templates select="parameter" mode="kr-tabular"/>
 416     <xsl:choose>
 417       <xsl:when test="following-sibling::*">
 418         <xsl:text>, </xsl:text>
 419       </xsl:when>
 420       <xsl:otherwise>
 421         <code>)</code>
 422         <xsl:text>;</xsl:text>
 423       </xsl:otherwise>
 424     </xsl:choose>
 425   </td>
 426   <td>&#160;</td>
 427 </xsl:template>
 428
 429 <xsl:template match="paramdef/parameter" mode="kr-tabular">
 430   <xsl:choose>
 431     <xsl:when test="$funcsynopsis.decoration != 0">
 432       <var class="pdparam">
 433         <xsl:apply-templates mode="kr-tabular"/>
 434       </var>
 435     </xsl:when>
 436     <xsl:otherwise>
 437       <code>
 438         <xsl:apply-templates mode="kr-tabular"/>
 439       </code>
 440     </xsl:otherwise>
 441   </xsl:choose>
 442 </xsl:template>
 443
 444 <xsl:template match="paramdef" mode="kr-tabular-funcsynopsis-mode">
 445   <xsl:variable name="type">
 446     <xsl:choose>
 447       <xsl:when test="type">
 448         <xsl:apply-templates select="type"
 449                              mode="kr-tabular-funcsynopsis-mode"/>
 450       </xsl:when>
 451       <xsl:when test="normalize-space(parameter/preceding-sibling::node()[not(self::parameter)]) != ''">
 452         <xsl:copy-of select="parameter/preceding-sibling::node()[not(self::parameter)]"/>
 453       </xsl:when>
 454     </xsl:choose>
 455   </xsl:variable>
 456
 457   <tr>
 458     <xsl:choose>
 459       <xsl:when test="$type != '' and funcparams">
 460         <td>
 461           <code>
 462             <xsl:copy-of select="$type"/>
 463           </code>
 464           <xsl:text>&#160;</xsl:text>
 465         </td>
 466         <td>
 467           <code>
 468             <xsl:choose>
 469               <xsl:when test="type">
 470                 <xsl:apply-templates select="type/following-sibling::*"
 471                                      mode="kr-tabular-funcsynopsis-mode"/>
 472               </xsl:when>
 473               <xsl:otherwise>
 474                 <xsl:apply-templates select="*"
 475                                      mode="kr-tabular-funcsynopsis-mode"/>
 476               </xsl:otherwise>
 477             </xsl:choose>
 478           </code>
 479         </td>
 480       </xsl:when>
 481
 482       <xsl:when test="funcparams">
 483         <td colspan="2">
 484           <code>
 485             <xsl:apply-templates mode="kr-tabular-funcsynopsis-mode"/>
 486           </code>
 487         </td>
 488       </xsl:when>
 489
 490       <xsl:otherwise>
 491         <td>
 492           <code>
 493             <xsl:apply-templates select="parameter/preceding-sibling::node()[not(self::parameter)]"
 494                                  mode="kr-tabular-funcsynopsis-mode"/>
 495           </code>
 496           <xsl:text>&#160;</xsl:text>
 497         </td>
 498         <td>
 499           <code>
 500             <xsl:apply-templates select="parameter"
 501                                  mode="kr-tabular"/>
 502             <xsl:apply-templates select="parameter/following-sibling::*[not(self::parameter)]"
 503                                  mode="kr-tabular-funcsynopsis-mode"/>
 504             <xsl:text>;</xsl:text>
 505           </code>
 506         </td>
 507       </xsl:otherwise>
 508     </xsl:choose>
 509   </tr>
 510 </xsl:template>
 511
 512 <xsl:template match="paramdef/parameter" mode="kr-tabular-funcsynopsis-mode">
 513   <xsl:choose>
 514     <xsl:when test="$funcsynopsis.decoration != 0">
 515       <var class="pdparam">
 516         <xsl:apply-templates mode="kr-tabular-funcsynopsis-mode"/>
 517       </var>
 518     </xsl:when>
 519     <xsl:otherwise>
 520       <code>
 521         <xsl:apply-templates mode="kr-tabular-funcsynopsis-mode"/>
 522       </code>
 523     </xsl:otherwise>
 524   </xsl:choose>
 525 </xsl:template>
 526
 527 <xsl:template match="funcparams" mode="kr-tabular-funcsynopsis-mode">
 528   <code>(</code>
 529   <xsl:apply-templates mode="kr-tabular-funcsynopsis-mode"/>
 530   <code>)</code>
 531   <xsl:text>;</xsl:text>
 532 </xsl:template>
 533
 534 <!-- ====================================================================== -->
 535 <!-- funcprototype: ansi, non-tabular -->
 536
 537 <xsl:template match="funcprototype" mode="ansi-nontabular">
 538   <p>
 539     <xsl:apply-templates mode="ansi-nontabular"/>
 540   </p>
 541 </xsl:template>
 542
 543 <xsl:template match="funcdef" mode="ansi-nontabular">
 544   <code>
 545     <xsl:apply-templates select="." mode="common.html.attributes"/>
 546     <xsl:apply-templates mode="ansi-nontabular"/>
 547     <xsl:text>(</xsl:text>
 548   </code>
 549 </xsl:template>
 550
 551 <xsl:template match="funcdef/function" mode="ansi-nontabular">
 552   <xsl:choose>
 553     <xsl:when test="$funcsynopsis.decoration != 0">
 554       <b class="fsfunc"><xsl:apply-templates mode="ansi-nontabular"/></b>
 555     </xsl:when>
 556     <xsl:otherwise>
 557       <xsl:apply-templates mode="ansi-nontabular"/>
 558     </xsl:otherwise>
 559   </xsl:choose>
 560 </xsl:template>
 561
 562 <xsl:template match="void" mode="ansi-nontabular">
 563   <code>void)</code>
 564   <xsl:text>;</xsl:text>
 565 </xsl:template>
 566
 567 <xsl:template match="varargs" mode="ansi-nontabular">
 568   <xsl:text>...</xsl:text>
 569   <code>)</code>
 570   <xsl:text>;</xsl:text>
 571 </xsl:template>
 572
 573 <xsl:template match="paramdef" mode="ansi-nontabular">
 574   <xsl:apply-templates mode="ansi-nontabular"/>
 575   <xsl:choose>
 576     <xsl:when test="following-sibling::*">
 577       <xsl:text>, </xsl:text>
 578     </xsl:when>
 579     <xsl:otherwise>
 580       <code>)</code>
 581       <xsl:text>;</xsl:text>
 582     </xsl:otherwise>
 583   </xsl:choose>
 584 </xsl:template>
 585
 586 <xsl:template match="paramdef/parameter" mode="ansi-nontabular">
 587   <xsl:choose>
 588     <xsl:when test="$funcsynopsis.decoration != 0">
 589       <var class="pdparam">
 590         <xsl:apply-templates mode="ansi-nontabular"/>
 591       </var>
 592     </xsl:when>
 593     <xsl:otherwise>
 594       <code>
 595         <xsl:apply-templates mode="ansi-nontabular"/>
 596       </code>
 597     </xsl:otherwise>
 598   </xsl:choose>
 599 </xsl:template>
 600
 601 <xsl:template match="funcparams" mode="ansi-nontabular">
 602   <code>(</code>
 603   <xsl:apply-templates mode="ansi-nontabular"/>
 604   <code>)</code>
 605 </xsl:template>
 606
 607 <!-- ====================================================================== -->
 608 <!-- funcprototype: ansi, tabular -->
 609
 610 <xsl:template match="funcprototype" mode="ansi-tabular">
 611   <table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"
 612     class="funcprototype-table"
 613     >
 614     <tr>
 615       <td>
 616         <xsl:apply-templates select="funcdef" mode="ansi-tabular"/>
 617       </td>
 618       <xsl:apply-templates select="(void|varargs|paramdef)[1]" mode="ansi-tabular"/>
 619     </tr>
 620     <xsl:for-each select="(void|varargs|paramdef)[preceding-sibling::*[not(self::funcdef)]]">
 621       <tr>
 622         <td>&#160;</td>
 623         <xsl:apply-templates select="." mode="ansi-tabular"/>
 624       </tr>
 625     </xsl:for-each>
 626   </table>
 627   <div class="funcprototype-spacer">&#160;</div> <!-- hACk: blank div for vertical spacing -->
 628 </xsl:template>
 629
 630 <xsl:template match="funcdef" mode="ansi-tabular">
 631   <code>
 632     <xsl:apply-templates select="." mode="common.html.attributes"/>
 633     <xsl:apply-templates mode="ansi-tabular"/>
 634     <xsl:text>(</xsl:text>
 635   </code>
 636 </xsl:template>
 637
 638 <xsl:template match="funcdef/function" mode="ansi-tabular">
 639   <xsl:choose>
 640     <xsl:when test="$funcsynopsis.decoration != 0">
 641       <b class="fsfunc"><xsl:apply-templates mode="ansi-nontabular"/></b>
 642     </xsl:when>
 643     <xsl:otherwise>
 644       <xsl:apply-templates mode="kr-tabular"/>
 645     </xsl:otherwise>
 646   </xsl:choose>
 647 </xsl:template>
 648
 649 <xsl:template match="void" mode="ansi-tabular">
 650   <td>
 651     <code>void)</code>
 652     <xsl:text>;</xsl:text>
 653   </td>
 654   <td>&#160;</td>
 655 </xsl:template>
 656
 657 <xsl:template match="varargs" mode="ansi-tabular">
 658   <td>
 659     <xsl:text>...</xsl:text>
 660     <code>)</code>
 661     <xsl:text>;</xsl:text>
 662   </td>
 663   <td>&#160;</td>
 664 </xsl:template>
 665
 666 <xsl:template match="paramdef" mode="ansi-tabular">
 667       <td>
 668         <xsl:apply-templates mode="ansi-tabular"/>
 669         <xsl:choose>
 670           <xsl:when test="following-sibling::*">
 671             <xsl:text>, </xsl:text>
 672           </xsl:when>
 673           <xsl:otherwise>
 674             <code>)</code>
 675             <xsl:text>;</xsl:text>
 676           </xsl:otherwise>
 677         </xsl:choose>
 678       </td>
 679 </xsl:template>
 680
 681 <xsl:template match="paramdef/parameter" mode="ansi-tabular">
 682   <xsl:choose>
 683     <xsl:when test="$funcsynopsis.decoration != 0">
 684       <var class="pdparam">
 685         <xsl:apply-templates mode="ansi-tabular"/>
 686       </var>
 687     </xsl:when>
 688     <xsl:otherwise>
 689       <code>
 690         <xsl:apply-templates mode="ansi-tabular"/>
 691       </code>
 692     </xsl:otherwise>
 693   </xsl:choose>
 694 </xsl:template>
 695
 696 <xsl:template match="funcparams" mode="ansi-tabular">
 697   <code>(</code>
 698   <xsl:apply-templates/>
 699   <code>)</code>
 700 </xsl:template>
 701
 702 <!-- ====================================================================== -->
 703
 704 <xsl:variable name="default-classsynopsis-language">java</xsl:variable>
 705
 706 <xsl:template match="classsynopsis
 707                      |fieldsynopsis
 708                      |methodsynopsis
 709                      |constructorsynopsis
 710                      |destructorsynopsis">
 711   <xsl:param name="language">
 712     <xsl:choose>
 713       <xsl:when test="@language">
 714         <xsl:value-of select="@language"/>
 715       </xsl:when>
 716       <xsl:otherwise>
 717         <xsl:value-of select="$default-classsynopsis-language"/>
 718       </xsl:otherwise>
 719     </xsl:choose>
 720   </xsl:param>
 721
 722   <xsl:choose>
 723     <xsl:when test="$language='java' or $language='Java'">
 724       <xsl:apply-templates select="." mode="java"/>
 725     </xsl:when>
 726     <xsl:when test="$language='perl' or $language='Perl'">
 727       <xsl:apply-templates select="." mode="perl"/>
 728     </xsl:when>
 729     <xsl:when test="$language='idl' or $language='IDL'">
 730       <xsl:apply-templates select="." mode="idl"/>
 731     </xsl:when>
 732     <xsl:when test="$language='cpp' or $language='c++' or $language='C++'">
 733       <xsl:apply-templates select="." mode="cpp"/>
 734     </xsl:when>
 735     <xsl:otherwise>
 736       <xsl:message>
 737         <xsl:text>Unrecognized language on </xsl:text>
 738         <xsl:value-of select="local-name(.)"/>
 739         <xsl:text>: </xsl:text>
 740         <xsl:value-of select="$language"/>
 741       </xsl:message>
 742       <xsl:apply-templates select=".">
 743         <xsl:with-param name="language"
 744           select="$default-classsynopsis-language"/>
 745       </xsl:apply-templates>
 746     </xsl:otherwise>
 747   </xsl:choose>
 748 </xsl:template>
 749
 750 <xsl:template name="synop-break">
 751   <xsl:if test="parent::classsynopsis
 752                 or (following-sibling::fieldsynopsis
 753                     |following-sibling::methodsynopsis
 754                     |following-sibling::constructorsynopsis
 755                     |following-sibling::destructorsynopsis)">
 756     <br/>
 757   </xsl:if>
 758 </xsl:template>
 759
 760
 761 <!-- ===== Java ======================================================== -->
 762
 763 <xsl:template match="classsynopsis" mode="java">
 764   <pre>
 765     <xsl:apply-templates select="." mode="common.html.attributes"/>
 766     <xsl:apply-templates select="ooclass[1]" mode="java"/>
 767     <xsl:if test="ooclass[preceding-sibling::*]">
 768       <xsl:text> extends</xsl:text>
 769       <xsl:apply-templates select="ooclass[preceding-sibling::*]" mode="java"/>
 770       <xsl:if test="oointerface|ooexception">
 771         <br/>
 772         <xsl:text>&nbsp;&nbsp;&nbsp;&nbsp;</xsl:text>
 773       </xsl:if>
 774     </xsl:if>
 775     <xsl:if test="oointerface">
 776       <xsl:text>implements</xsl:text>
 777       <xsl:apply-templates select="oointerface" mode="java"/>
 778       <xsl:if test="ooexception">
 779         <br/>
 780         <xsl:text>&nbsp;&nbsp;&nbsp;&nbsp;</xsl:text>
 781       </xsl:if>
 782     </xsl:if>
 783     <xsl:if test="ooexception">
 784       <xsl:text>throws</xsl:text>
 785       <xsl:apply-templates select="ooexception" mode="java"/>
 786     </xsl:if>
 787     <xsl:text>&nbsp;{</xsl:text>
 788     <br/>
 789     <xsl:apply-templates select="constructorsynopsis
 790                                  |destructorsynopsis
 791                                  |fieldsynopsis
 792                                  |methodsynopsis
 793                                  |classsynopsisinfo" mode="java"/>
 794     <xsl:text>}</xsl:text>
 795   </pre>
 796 </xsl:template>
 797
 798 <xsl:template match="classsynopsisinfo" mode="java">
 799   <xsl:apply-templates mode="java"/>
 800 </xsl:template>
 801
 802 <xsl:template match="ooclass|oointerface|ooexception" mode="java">
 803   <xsl:choose>
 804     <xsl:when test="preceding-sibling::*">
 805       <xsl:text>, </xsl:text>
 806     </xsl:when>
 807     <xsl:otherwise>
 808       <xsl:text> </xsl:text>
 809     </xsl:otherwise>
 810   </xsl:choose>
 811   <span>
 812     <xsl:apply-templates select="." mode="common.html.attributes"/>
 813     <xsl:apply-templates mode="java"/>
 814   </span>
 815 </xsl:template>
 816
 817 <xsl:template match="modifier|package" mode="java">
 818   <span>
 819     <xsl:apply-templates select="." mode="common.html.attributes"/>
 820     <xsl:apply-templates mode="java"/>
 821     <xsl:if test="following-sibling::*">
 822       <xsl:text>&nbsp;</xsl:text>
 823     </xsl:if>
 824   </span>
 825 </xsl:template>
 826
 827 <xsl:template match="classname" mode="java">
 828   <xsl:if test="local-name(preceding-sibling::*[1]) = 'classname'">
 829     <xsl:text>, </xsl:text>
 830   </xsl:if>
 831   <span>
 832     <xsl:apply-templates select="." mode="common.html.attributes"/>
 833     <xsl:apply-templates mode="java"/>
 834   </span>
 835 </xsl:template>
 836
 837 <xsl:template match="interfacename" mode="java">
 838   <xsl:if test="local-name(preceding-sibling::*[1]) = 'interfacename'">
 839     <xsl:text>, </xsl:text>
 840   </xsl:if>
 841   <span>
 842     <xsl:apply-templates select="." mode="common.html.attributes"/>
 843     <xsl:apply-templates mode="java"/>
 844   </span>
 845 </xsl:template>
 846
 847 <xsl:template match="exceptionname" mode="java">
 848   <xsl:if test="local-name(preceding-sibling::*[1]) = 'exceptionname'">
 849     <xsl:text>, </xsl:text>
 850   </xsl:if>
 851   <span>
 852     <xsl:apply-templates select="." mode="common.html.attributes"/>
 853     <xsl:apply-templates mode="java"/>
 854   </span>
 855 </xsl:template>
 856
 857 <xsl:template match="fieldsynopsis" mode="java">
 858   <code>
 859     <xsl:apply-templates select="." mode="common.html.attributes"/>
 860     <xsl:if test="parent::classsynopsis">
 861       <xsl:text>&nbsp;&nbsp;</xsl:text>
 862     </xsl:if>
 863     <xsl:apply-templates mode="java"/>
 864     <xsl:text>;</xsl:text>
 865   </code>
 866   <xsl:call-template name="synop-break"/>
 867 </xsl:template>
 868
 869 <xsl:template match="type" mode="java">
 870   <span>
 871     <xsl:apply-templates select="." mode="common.html.attributes"/>
 872     <xsl:apply-templates mode="java"/>
 873     <xsl:text>&nbsp;</xsl:text>
 874   </span>
 875 </xsl:template>
 876
 877 <xsl:template match="varname" mode="java">
 878   <span>
 879     <xsl:apply-templates select="." mode="common.html.attributes"/>
 880     <xsl:apply-templates mode="java"/>
 881     <xsl:text>&nbsp;</xsl:text>
 882   </span>
 883 </xsl:template>
 884
 885 <xsl:template match="initializer" mode="java">
 886   <span>
 887     <xsl:apply-templates select="." mode="common.html.attributes"/>
 888     <xsl:text>=&nbsp;</xsl:text>
 889     <xsl:apply-templates mode="java"/>
 890   </span>
 891 </xsl:template>
 892
 893 <xsl:template match="void" mode="java">
 894   <span>
 895     <xsl:apply-templates select="." mode="common.html.attributes"/>
 896     <xsl:text>void&nbsp;</xsl:text>
 897   </span>
 898 </xsl:template>
 899
 900 <xsl:template match="methodname" mode="java">
 901   <span>
 902     <xsl:apply-templates select="." mode="common.html.attributes"/>
 903     <xsl:apply-templates mode="java"/>
 904   </span>
 905 </xsl:template>
 906
 907 <xsl:template match="methodparam" mode="java">
 908   <xsl:param name="indent">0</xsl:param>
 909   <xsl:if test="preceding-sibling::methodparam">
 910     <xsl:text>,</xsl:text>
 911     <br/>
 912     <xsl:if test="$indent &gt; 0">
 913       <xsl:call-template name="copy-string">
 914         <xsl:with-param name="string">&nbsp;</xsl:with-param>
 915         <xsl:with-param name="count" select="$indent + 1"/>
 916       </xsl:call-template>
 917     </xsl:if>
 918   </xsl:if>
 919   <span>
 920     <xsl:apply-templates select="." mode="common.html.attributes"/>
 921     <xsl:apply-templates mode="java"/>
 922   </span>
 923 </xsl:template>
 924
 925 <xsl:template match="parameter" mode="java">
 926   <span>
 927     <xsl:apply-templates select="." mode="common.html.attributes"/>
 928     <xsl:apply-templates mode="java"/>
 929   </span>
 930 </xsl:template>
 931
 932 <xsl:template mode="java"
 933   match="constructorsynopsis|destructorsynopsis|methodsynopsis">
 934   <xsl:variable name="start-modifiers" select="modifier[following-sibling::*[local-name(.) != 'modifier']]"/>
 935   <xsl:variable name="notmod" select="*[local-name(.) != 'modifier']"/>
 936   <xsl:variable name="end-modifiers" select="modifier[preceding-sibling::*[local-name(.) != 'modifier']]"/>
 937   <xsl:variable name="decl">
 938     <xsl:if test="parent::classsynopsis">
 939       <xsl:text>&nbsp;&nbsp;</xsl:text>
 940     </xsl:if>
 941     <xsl:apply-templates select="$start-modifiers" mode="java"/>
 942
 943     <!-- type -->
 944     <xsl:if test="local-name($notmod[1]) != 'methodname'">
 945       <xsl:apply-templates select="$notmod[1]" mode="java"/>
 946     </xsl:if>
 947
 948     <xsl:apply-templates select="methodname" mode="java"/>
 949   </xsl:variable>
 950
 951   <code>
 952     <xsl:apply-templates select="." mode="common.html.attributes"/>
 953     <xsl:copy-of select="$decl"/>
 954     <xsl:text>(</xsl:text>
 955     <xsl:apply-templates select="methodparam" mode="java">
 956       <xsl:with-param name="indent" select="string-length($decl)"/>
 957     </xsl:apply-templates>
 958     <xsl:text>)</xsl:text>
 959     <xsl:if test="exceptionname">
 960       <br/>
 961       <xsl:text>&nbsp;&nbsp;&nbsp;&nbsp;throws&nbsp;</xsl:text>
 962       <xsl:apply-templates select="exceptionname" mode="java"/>
 963     </xsl:if>
 964     <xsl:if test="modifier[preceding-sibling::*[local-name(.) != 'modifier']]">
 965       <xsl:text> </xsl:text>
 966       <xsl:apply-templates select="$end-modifiers" mode="java"/>
 967     </xsl:if>
 968     <xsl:text>;</xsl:text>
 969   </code>
 970   <xsl:call-template name="synop-break"/>
 971 </xsl:template>
 972
 973 <!-- ===== C++ ========================================================= -->
 974
 975 <xsl:template match="classsynopsis" mode="cpp">
 976   <pre>
 977     <xsl:apply-templates select="." mode="common.html.attributes"/>
 978     <xsl:apply-templates select="ooclass[1]" mode="cpp"/>
 979     <xsl:if test="ooclass[preceding-sibling::*]">
 980       <xsl:text>: </xsl:text>
 981       <xsl:apply-templates select="ooclass[preceding-sibling::*]" mode="cpp"/>
 982       <xsl:if test="oointerface|ooexception">
 983         <br/>
 984         <xsl:text>&nbsp;&nbsp;&nbsp;&nbsp;</xsl:text>
 985       </xsl:if>
 986     </xsl:if>
 987     <xsl:if test="oointerface">
 988       <xsl:text> implements</xsl:text>
 989       <xsl:apply-templates select="oointerface" mode="cpp"/>
 990       <xsl:if test="ooexception">
 991         <br/>
 992         <xsl:text>&nbsp;&nbsp;&nbsp;&nbsp;</xsl:text>
 993       </xsl:if>
 994     </xsl:if>
 995     <xsl:if test="ooexception">
 996       <xsl:text> throws</xsl:text>
 997       <xsl:apply-templates select="ooexception" mode="cpp"/>
 998     </xsl:if>
 999     <xsl:text>&nbsp;{</xsl:text>
1000     <br/>
1001     <xsl:apply-templates select="constructorsynopsis
1002                                  |destructorsynopsis
1003                                  |fieldsynopsis
1004                                  |methodsynopsis
1005                                  |classsynopsisinfo" mode="cpp"/>
1006     <xsl:text>}</xsl:text>
1007   </pre>
1008 </xsl:template>
1009
1010 <xsl:template match="classsynopsisinfo" mode="cpp">
1011   <xsl:apply-templates mode="cpp"/>
1012 </xsl:template>
1013
1014 <xsl:template match="ooclass|oointerface|ooexception" mode="cpp">
1015   <xsl:if test="preceding-sibling::*">
1016     <xsl:text>, </xsl:text>
1017   </xsl:if>
1018   <span>
1019     <xsl:apply-templates select="." mode="common.html.attributes"/>
1020     <xsl:apply-templates mode="cpp"/>
1021   </span>
1022 </xsl:template>
1023
1024 <xsl:template match="modifier|package" mode="cpp">
1025   <span>
1026     <xsl:apply-templates select="." mode="common.html.attributes"/>
1027     <xsl:apply-templates mode="cpp"/>
1028     <xsl:if test="following-sibling::*">
1029       <xsl:text>&nbsp;</xsl:text>
1030     </xsl:if>
1031   </span>
1032 </xsl:template>
1033
1034 <xsl:template match="classname" mode="cpp">
1035   <xsl:if test="local-name(preceding-sibling::*[1]) = 'classname'">
1036     <xsl:text>, </xsl:text>
1037   </xsl:if>
1038   <span>
1039     <xsl:apply-templates select="." mode="common.html.attributes"/>
1040     <xsl:apply-templates mode="cpp"/>
1041   </span>
1042 </xsl:template>
1043
1044 <xsl:template match="interfacename" mode="cpp">
1045   <xsl:if test="local-name(preceding-sibling::*[1]) = 'interfacename'">
1046     <xsl:text>, </xsl:text>
1047   </xsl:if>
1048   <span>
1049     <xsl:apply-templates select="." mode="common.html.attributes"/>
1050     <xsl:apply-templates mode="cpp"/>
1051   </span>
1052 </xsl:template>
1053
1054 <xsl:template match="exceptionname" mode="cpp">
1055   <xsl:if test="local-name(preceding-sibling::*[1]) = 'exceptionname'">
1056     <xsl:text>, </xsl:text>
1057   </xsl:if>
1058   <span>
1059     <xsl:apply-templates select="." mode="common.html.attributes"/>
1060     <xsl:apply-templates mode="cpp"/>
1061   </span>
1062 </xsl:template>
1063
1064 <xsl:template match="fieldsynopsis" mode="cpp">
1065   <code>
1066     <xsl:apply-templates select="." mode="common.html.attributes"/>
1067     <xsl:if test="parent::classsynopsis">
1068       <xsl:text>&nbsp;&nbsp;</xsl:text>
1069     </xsl:if>
1070     <xsl:apply-templates mode="cpp"/>
1071     <xsl:text>;</xsl:text>
1072   </code>
1073   <xsl:call-template name="synop-break"/>
1074 </xsl:template>
1075
1076 <xsl:template match="type" mode="cpp">
1077   <span>
1078     <xsl:apply-templates select="." mode="common.html.attributes"/>
1079     <xsl:apply-templates mode="cpp"/>
1080     <xsl:text>&nbsp;</xsl:text>
1081   </span>
1082 </xsl:template>
1083
1084 <xsl:template match="varname" mode="cpp">
1085   <span>
1086     <xsl:apply-templates select="." mode="common.html.attributes"/>
1087     <xsl:apply-templates mode="cpp"/>
1088     <xsl:text>&nbsp;</xsl:text>
1089   </span>
1090 </xsl:template>
1091
1092 <xsl:template match="initializer" mode="cpp">
1093   <span>
1094     <xsl:apply-templates select="." mode="common.html.attributes"/>
1095     <xsl:text>=&nbsp;</xsl:text>
1096     <xsl:apply-templates mode="cpp"/>
1097   </span>
1098 </xsl:template>
1099
1100 <xsl:template match="void" mode="cpp">
1101   <span>
1102     <xsl:apply-templates select="." mode="common.html.attributes"/>
1103     <xsl:text>void&nbsp;</xsl:text>
1104   </span>
1105 </xsl:template>
1106
1107 <xsl:template match="methodname" mode="cpp">
1108   <span>
1109     <xsl:apply-templates select="." mode="common.html.attributes"/>
1110     <xsl:apply-templates mode="cpp"/>
1111   </span>
1112 </xsl:template>
1113
1114 <xsl:template match="methodparam" mode="cpp">
1115   <xsl:if test="preceding-sibling::methodparam">
1116     <xsl:text>, </xsl:text>
1117   </xsl:if>
1118   <span>
1119     <xsl:apply-templates select="." mode="common.html.attributes"/>
1120     <xsl:apply-templates mode="cpp"/>
1121   </span>
1122 </xsl:template>
1123
1124 <xsl:template match="parameter" mode="cpp">
1125   <span>
1126     <xsl:apply-templates select="." mode="common.html.attributes"/>
1127     <xsl:apply-templates mode="cpp"/>
1128   </span>
1129 </xsl:template>
1130
1131 <xsl:template mode="cpp"
1132   match="constructorsynopsis|destructorsynopsis|methodsynopsis">
1133   <xsl:variable name="start-modifiers" select="modifier[following-sibling::*[local-name(.) != 'modifier']]"/>
1134   <xsl:variable name="notmod" select="*[local-name(.) != 'modifier']"/>
1135   <xsl:variable name="end-modifiers" select="modifier[preceding-sibling::*[local-name(.) != 'modifier']]"/>
1136
1137   <code>
1138     <xsl:apply-templates select="." mode="common.html.attributes"/>
1139     <xsl:if test="parent::classsynopsis">
1140       <xsl:text>&nbsp;&nbsp;</xsl:text>
1141     </xsl:if>
1142     <xsl:apply-templates select="$start-modifiers" mode="cpp"/>
1143
1144     <!-- type -->
1145     <xsl:if test="local-name($notmod[1]) != 'methodname'">
1146       <xsl:apply-templates select="$notmod[1]" mode="cpp"/>
1147     </xsl:if>
1148
1149     <xsl:apply-templates select="methodname" mode="cpp"/>
1150     <xsl:text>(</xsl:text>
1151     <xsl:apply-templates select="methodparam" mode="cpp"/>
1152     <xsl:text>)</xsl:text>
1153     <xsl:if test="exceptionname">
1154       <br/>
1155       <xsl:text>&nbsp;&nbsp;&nbsp;&nbsp;throws&nbsp;</xsl:text>
1156       <xsl:apply-templates select="exceptionname" mode="cpp"/>
1157     </xsl:if>
1158     <xsl:if test="modifier[preceding-sibling::*[local-name(.) != 'modifier']]">
1159       <xsl:text> </xsl:text>
1160       <xsl:apply-templates select="$end-modifiers" mode="cpp"/>
1161     </xsl:if>
1162     <xsl:text>;</xsl:text>
1163   </code>
1164   <xsl:call-template name="synop-break"/>
1165 </xsl:template>
1166
1167 <!-- ===== IDL ========================================================= -->
1168
1169 <xsl:template match="classsynopsis" mode="idl">
1170   <pre>
1171     <xsl:apply-templates select="." mode="common.html.attributes"/>
1172     <xsl:text>interface </xsl:text>
1173     <xsl:apply-templates select="ooclass[1]" mode="idl"/>
1174     <xsl:if test="ooclass[preceding-sibling::*]">
1175       <xsl:text>: </xsl:text>
1176       <xsl:apply-templates select="ooclass[preceding-sibling::*]" mode="idl"/>
1177       <xsl:if test="oointerface|ooexception">
1178         <br/>
1179         <xsl:text>&nbsp;&nbsp;&nbsp;&nbsp;</xsl:text>
1180       </xsl:if>
1181     </xsl:if>
1182     <xsl:if test="oointerface">
1183       <xsl:text> implements</xsl:text>
1184       <xsl:apply-templates select="oointerface" mode="idl"/>
1185       <xsl:if test="ooexception">
1186         <br/>
1187         <xsl:text>&nbsp;&nbsp;&nbsp;&nbsp;</xsl:text>
1188       </xsl:if>
1189     </xsl:if>
1190     <xsl:if test="ooexception">
1191       <xsl:text> throws</xsl:text>
1192       <xsl:apply-templates select="ooexception" mode="idl"/>
1193     </xsl:if>
1194     <xsl:text>&nbsp;{</xsl:text>
1195     <br/>
1196     <xsl:apply-templates select="constructorsynopsis
1197                                  |destructorsynopsis
1198                                  |fieldsynopsis
1199                                  |methodsynopsis
1200                                  |classsynopsisinfo" mode="idl"/>
1201     <xsl:text>}</xsl:text>
1202   </pre>
1203 </xsl:template>
1204
1205 <xsl:template match="classsynopsisinfo" mode="idl">
1206   <xsl:apply-templates mode="idl"/>
1207 </xsl:template>
1208
1209 <xsl:template match="ooclass|oointerface|ooexception" mode="idl">
1210   <xsl:if test="preceding-sibling::*">
1211     <xsl:text>, </xsl:text>
1212   </xsl:if>
1213   <span>
1214     <xsl:apply-templates select="." mode="common.html.attributes"/>
1215     <xsl:apply-templates mode="idl"/>
1216   </span>
1217 </xsl:template>
1218
1219 <xsl:template match="modifier|package" mode="idl">
1220   <span>
1221     <xsl:apply-templates select="." mode="common.html.attributes"/>
1222     <xsl:apply-templates mode="idl"/>
1223     <xsl:if test="following-sibling::*">
1224       <xsl:text>&nbsp;</xsl:text>
1225     </xsl:if>
1226   </span>
1227 </xsl:template>
1228
1229 <xsl:template match="classname" mode="idl">
1230   <xsl:if test="local-name(preceding-sibling::*[1]) = 'classname'">
1231     <xsl:text>, </xsl:text>
1232   </xsl:if>
1233   <span>
1234     <xsl:apply-templates select="." mode="common.html.attributes"/>
1235     <xsl:apply-templates mode="idl"/>
1236   </span>
1237 </xsl:template>
1238
1239 <xsl:template match="interfacename" mode="idl">
1240   <xsl:if test="local-name(preceding-sibling::*[1]) = 'interfacename'">
1241     <xsl:text>, </xsl:text>
1242   </xsl:if>
1243   <span>
1244     <xsl:apply-templates select="." mode="common.html.attributes"/>
1245     <xsl:apply-templates mode="idl"/>
1246   </span>
1247 </xsl:template>
1248
1249 <xsl:template match="exceptionname" mode="idl">
1250   <xsl:if test="local-name(preceding-sibling::*[1]) = 'exceptionname'">
1251     <xsl:text>, </xsl:text>
1252   </xsl:if>
1253   <span>
1254     <xsl:apply-templates select="." mode="common.html.attributes"/>
1255     <xsl:apply-templates mode="idl"/>
1256   </span>
1257 </xsl:template>
1258
1259 <xsl:template match="fieldsynopsis" mode="idl">
1260   <code>
1261     <xsl:apply-templates select="." mode="common.html.attributes"/>
1262     <xsl:if test="parent::classsynopsis">
1263       <xsl:text>&nbsp;&nbsp;</xsl:text>
1264     </xsl:if>
1265     <xsl:apply-templates mode="idl"/>
1266     <xsl:text>;</xsl:text>
1267   </code>
1268   <xsl:call-template name="synop-break"/>
1269 </xsl:template>
1270
1271 <xsl:template match="type" mode="idl">
1272   <span>
1273     <xsl:apply-templates select="." mode="common.html.attributes"/>
1274     <xsl:apply-templates mode="idl"/>
1275     <xsl:text>&nbsp;</xsl:text>
1276   </span>
1277 </xsl:template>
1278
1279 <xsl:template match="varname" mode="idl">
1280   <span>
1281     <xsl:apply-templates select="." mode="common.html.attributes"/>
1282     <xsl:apply-templates mode="idl"/>
1283     <xsl:text>&nbsp;</xsl:text>
1284   </span>
1285 </xsl:template>
1286
1287 <xsl:template match="initializer" mode="idl">
1288   <span>
1289     <xsl:apply-templates select="." mode="common.html.attributes"/>
1290     <xsl:text>=&nbsp;</xsl:text>
1291     <xsl:apply-templates mode="idl"/>
1292   </span>
1293 </xsl:template>
1294
1295 <xsl:template match="void" mode="idl">
1296   <span>
1297     <xsl:apply-templates select="." mode="common.html.attributes"/>
1298     <xsl:text>void&nbsp;</xsl:text>
1299   </span>
1300 </xsl:template>
1301
1302 <xsl:template match="methodname" mode="idl">
1303   <span>
1304     <xsl:apply-templates select="." mode="common.html.attributes"/>
1305     <xsl:apply-templates mode="idl"/>
1306   </span>
1307 </xsl:template>
1308
1309 <xsl:template match="methodparam" mode="idl">
1310   <xsl:if test="preceding-sibling::methodparam">
1311     <xsl:text>, </xsl:text>
1312   </xsl:if>
1313   <span>
1314     <xsl:apply-templates select="." mode="common.html.attributes"/>
1315     <xsl:apply-templates mode="idl"/>
1316   </span>
1317 </xsl:template>
1318
1319 <xsl:template match="parameter" mode="idl">
1320   <span>
1321     <xsl:apply-templates select="." mode="common.html.attributes"/>
1322     <xsl:apply-templates mode="idl"/>
1323   </span>
1324 </xsl:template>
1325
1326 <xsl:template mode="idl"
1327   match="constructorsynopsis|destructorsynopsis|methodsynopsis">
1328   <xsl:variable name="start-modifiers" select="modifier[following-sibling::*[local-name(.) != 'modifier']]"/>
1329   <xsl:variable name="notmod" select="*[local-name(.) != 'modifier']"/>
1330   <xsl:variable name="end-modifiers" select="modifier[preceding-sibling::*[local-name(.) != 'modifier']]"/>
1331   <code>
1332     <xsl:apply-templates select="." mode="common.html.attributes"/>
1333     <xsl:if test="parent::classsynopsis">
1334       <xsl:text>&nbsp;&nbsp;</xsl:text>
1335     </xsl:if>
1336     <xsl:apply-templates select="$start-modifiers" mode="idl"/>
1337
1338     <!-- type -->
1339     <xsl:if test="local-name($notmod[1]) != 'methodname'">
1340       <xsl:apply-templates select="$notmod[1]" mode="idl"/>
1341     </xsl:if>
1342
1343     <xsl:apply-templates select="methodname" mode="idl"/>
1344     <xsl:text>(</xsl:text>
1345     <xsl:apply-templates select="methodparam" mode="idl"/>
1346     <xsl:text>)</xsl:text>
1347     <xsl:if test="exceptionname">
1348       <br/>
1349       <xsl:text>&nbsp;&nbsp;&nbsp;&nbsp;raises(</xsl:text>
1350       <xsl:apply-templates select="exceptionname" mode="idl"/>
1351       <xsl:text>)</xsl:text>
1352     </xsl:if>
1353     <xsl:if test="modifier[preceding-sibling::*[local-name(.) != 'modifier']]">
1354       <xsl:text> </xsl:text>
1355       <xsl:apply-templates select="$end-modifiers" mode="idl"/>
1356     </xsl:if>
1357     <xsl:text>;</xsl:text>
1358   </code>
1359   <xsl:call-template name="synop-break"/>
1360 </xsl:template>
1361
1362 <!-- ===== Perl ======================================================== -->
1363
1364 <xsl:template match="classsynopsis" mode="perl">
1365   <pre>
1366     <xsl:apply-templates select="." mode="common.html.attributes"/>
1367     <xsl:text>package </xsl:text>
1368     <xsl:apply-templates select="ooclass[1]" mode="perl"/>
1369     <xsl:text>;</xsl:text>
1370     <br/>
1371
1372     <xsl:if test="ooclass[preceding-sibling::*]">
1373       <xsl:text>@ISA = (</xsl:text>
1374       <xsl:apply-templates select="ooclass[preceding-sibling::*]" mode="perl"/>
1375       <xsl:text>);</xsl:text>
1376       <br/>
1377     </xsl:if>
1378
1379     <xsl:apply-templates select="constructorsynopsis
1380                                  |destructorsynopsis
1381                                  |fieldsynopsis
1382                                  |methodsynopsis
1383                                  |classsynopsisinfo" mode="perl"/>
1384   </pre>
1385 </xsl:template>
1386
1387 <xsl:template match="classsynopsisinfo" mode="perl">
1388   <xsl:apply-templates mode="perl"/>
1389 </xsl:template>
1390
1391 <xsl:template match="ooclass|oointerface|ooexception" mode="perl">
1392   <xsl:if test="preceding-sibling::*">
1393     <xsl:text>, </xsl:text>
1394   </xsl:if>
1395   <span>
1396     <xsl:apply-templates select="." mode="common.html.attributes"/>
1397     <xsl:apply-templates mode="perl"/>
1398   </span>
1399 </xsl:template>
1400
1401 <xsl:template match="modifier|package" mode="perl">
1402   <span>
1403     <xsl:apply-templates select="." mode="common.html.attributes"/>
1404     <xsl:apply-templates mode="perl"/>
1405     <xsl:if test="following-sibling::*">
1406       <xsl:text>&nbsp;</xsl:text>
1407     </xsl:if>
1408   </span>
1409 </xsl:template>
1410
1411 <xsl:template match="classname" mode="perl">
1412   <xsl:if test="local-name(preceding-sibling::*[1]) = 'classname'">
1413     <xsl:text>, </xsl:text>
1414   </xsl:if>
1415   <span>
1416     <xsl:apply-templates select="." mode="common.html.attributes"/>
1417     <xsl:apply-templates mode="perl"/>
1418   </span>
1419 </xsl:template>
1420
1421 <xsl:template match="interfacename" mode="perl">
1422   <xsl:if test="local-name(preceding-sibling::*[1]) = 'interfacename'">
1423     <xsl:text>, </xsl:text>
1424   </xsl:if>
1425   <span>
1426     <xsl:apply-templates select="." mode="common.html.attributes"/>
1427     <xsl:apply-templates mode="perl"/>
1428   </span>
1429 </xsl:template>
1430
1431 <xsl:template match="exceptionname" mode="perl">
1432   <xsl:if test="local-name(preceding-sibling::*[1]) = 'exceptionname'">
1433     <xsl:text>, </xsl:text>
1434   </xsl:if>
1435   <span>
1436     <xsl:apply-templates select="." mode="common.html.attributes"/>
1437     <xsl:apply-templates mode="perl"/>
1438   </span>
1439 </xsl:template>
1440
1441 <xsl:template match="fieldsynopsis" mode="perl">
1442   <code>
1443     <xsl:apply-templates select="." mode="common.html.attributes"/>
1444     <xsl:if test="parent::classsynopsis">
1445       <xsl:text>&nbsp;&nbsp;</xsl:text>
1446     </xsl:if>
1447     <xsl:apply-templates mode="perl"/>
1448     <xsl:text>;</xsl:text>
1449   </code>
1450   <xsl:call-template name="synop-break"/>
1451 </xsl:template>
1452
1453 <xsl:template match="type" mode="perl">
1454   <span>
1455     <xsl:apply-templates select="." mode="common.html.attributes"/>
1456     <xsl:apply-templates mode="perl"/>
1457     <xsl:text>&nbsp;</xsl:text>
1458   </span>
1459 </xsl:template>
1460
1461 <xsl:template match="varname" mode="perl">
1462   <span>
1463     <xsl:apply-templates select="." mode="common.html.attributes"/>
1464     <xsl:apply-templates mode="perl"/>
1465     <xsl:text>&nbsp;</xsl:text>
1466   </span>
1467 </xsl:template>
1468
1469 <xsl:template match="initializer" mode="perl">
1470   <span>
1471     <xsl:apply-templates select="." mode="common.html.attributes"/>
1472     <xsl:text>=&nbsp;</xsl:text>
1473     <xsl:apply-templates mode="perl"/>
1474   </span>
1475 </xsl:template>
1476
1477 <xsl:template match="void" mode="perl">
1478   <span>
1479     <xsl:apply-templates select="." mode="common.html.attributes"/>
1480     <xsl:text>void&nbsp;</xsl:text>
1481   </span>
1482 </xsl:template>
1483
1484 <xsl:template match="methodname" mode="perl">
1485   <span>
1486     <xsl:apply-templates select="." mode="common.html.attributes"/>
1487     <xsl:apply-templates mode="perl"/>
1488   </span>
1489 </xsl:template>
1490
1491 <xsl:template match="methodparam" mode="perl">
1492   <xsl:if test="preceding-sibling::methodparam">
1493     <xsl:text>, </xsl:text>
1494   </xsl:if>
1495   <span>
1496     <xsl:apply-templates select="." mode="common.html.attributes"/>
1497     <xsl:apply-templates mode="perl"/>
1498   </span>
1499 </xsl:template>
1500
1501 <xsl:template match="parameter" mode="perl">
1502   <span>
1503     <xsl:apply-templates select="." mode="common.html.attributes"/>
1504     <xsl:apply-templates mode="perl"/>
1505   </span>
1506 </xsl:template>
1507
1508 <xsl:template mode="perl"
1509   match="constructorsynopsis|destructorsynopsis|methodsynopsis">
1510   <xsl:variable name="start-modifiers" select="modifier[following-sibling::*[local-name(.) != 'modifier']]"/>
1511   <xsl:variable name="notmod" select="*[local-name(.) != 'modifier']"/>
1512   <xsl:variable name="end-modifiers" select="modifier[preceding-sibling::*[local-name(.) != 'modifier']]"/>
1513
1514   <code>
1515     <xsl:apply-templates select="." mode="common.html.attributes"/>
1516     <xsl:text>sub </xsl:text>
1517
1518     <xsl:apply-templates select="methodname" mode="perl"/>
1519     <xsl:text> { ... };</xsl:text>
1520   </code>
1521   <xsl:call-template name="synop-break"/>
1522 </xsl:template>
1523
1524 <!-- Used when not occurring as a child of classsynopsis -->
1525 <xsl:template match="ooclass|oointerface|ooexception">
1526   <xsl:apply-templates/>
1527 </xsl:template>
1528
1529 <!-- ==================================================================== -->
1530
1531 <!-- * DocBook 5 allows linking elements (link, olink, and xref) -->
1532 <!-- * within the OO *synopsis elements (classsynopsis, fieldsynopsis, -->
1533 <!-- * methodsynopsis, constructorsynopsis, destructorsynopsis) and -->
1534 <!-- * their children. So we need to have mode="java|cpp|idl|perl" -->
1535 <!-- * per-mode matches for those linking elements in order for them -->
1536 <!-- * to be processed as expected. -->
1537
1538 <xsl:template match="link|olink|xref" mode="java">
1539   <xsl:apply-templates select="."/>
1540 </xsl:template>
1541
1542 <xsl:template match="link|olink|xref" mode="cpp">
1543   <xsl:apply-templates select="."/>
1544 </xsl:template>
1545
1546 <xsl:template match="link|olink|xref" mode="idl">
1547   <xsl:apply-templates select="."/>
1548 </xsl:template>
1549
1550 <xsl:template match="link|olink|xref" mode="perl">
1551   <xsl:apply-templates select="."/>
1552 </xsl:template>
1553
1554 </xsl:stylesheet>