stylesheets/evergreen_docbook_files/docbook-xsl-1.75.2/common/common.xml

   1 <?xml version="1.0"?>\r
   2 \r
   3 <reference xml:id="base">\r
   4   <info>\r
   5     <title>Common » Base Template Reference</title>\r
   6     <releaseinfo role="meta">\r
   7       $Id: common.xsl 8274 2009-02-27 07:02:45Z bobstayton $\r
   8     </releaseinfo>\r
   9   </info>\r
  10   \r
  11   <partintro xml:id="partintro">\r
  12     <title>Introduction</title>\r
  13     \r
  14 <para>This is technical reference documentation for the “base”\r
  15       set of common templates in the DocBook XSL Stylesheets.</para>\r
  16 \r
  17     \r
  18 <para>This is not intended to be user documentation. It is\r
  19       provided for developers writing customization layers for the\r
  20       stylesheets.</para>\r
  21 \r
  22   </partintro>\r
  23 \r
  24 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="template.is.component">\r
  25 <refnamediv>\r
  26 <refname>is.component</refname>\r
  27 <refpurpose>Tests if a given node is a component-level element</refpurpose>\r
  28 </refnamediv>\r
  29 <refsynopsisdiv>\r
  30 <synopsis>&lt;xsl:template name="is.component"&gt;\r
  31 &lt;xsl:param name="node" select="."/&gt;\r
  32   ...\r
  33 &lt;/xsl:template&gt;</synopsis>\r
  34 </refsynopsisdiv>\r
  35 <refsect1><title>Description</title>\r
  36 \r
  37 <para>This template returns '1' if the specified node is a component\r
  38 (Chapter, Appendix, etc.), and '0' otherwise.</para>\r
  39 \r
  40 </refsect1><refsect1><title>Parameters</title>\r
  41 \r
  42 <variablelist>\r
  43 <varlistentry><term>node</term>\r
  44 <listitem>\r
  45 \r
  46 <para>The node which is to be tested.</para>\r
  47 \r
  48 </listitem>\r
  49 </varlistentry>\r
  50 </variablelist>\r
  51 \r
  52 </refsect1><refsect1><title>Returns</title>\r
  53 \r
  54 <para>This template returns '1' if the specified node is a component\r
  55 (Chapter, Appendix, etc.), and '0' otherwise.</para>\r
  56 \r
  57 </refsect1></refentry>\r
  58 \r
  59 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="template.is.section">\r
  60 <refnamediv>\r
  61 <refname>is.section</refname>\r
  62 <refpurpose>Tests if a given node is a section-level element</refpurpose>\r
  63 </refnamediv>\r
  64 <refsynopsisdiv>\r
  65 <synopsis>&lt;xsl:template name="is.section"&gt;\r
  66 &lt;xsl:param name="node" select="."/&gt;\r
  67   ...\r
  68 &lt;/xsl:template&gt;</synopsis>\r
  69 </refsynopsisdiv>\r
  70 <refsect1><title>Description</title>\r
  71 \r
  72 <para>This template returns '1' if the specified node is a section\r
  73 (Section, Sect1, Sect2, etc.), and '0' otherwise.</para>\r
  74 \r
  75 </refsect1><refsect1><title>Parameters</title>\r
  76 \r
  77 <variablelist>\r
  78 <varlistentry><term>node</term>\r
  79 <listitem>\r
  80 \r
  81 <para>The node which is to be tested.</para>\r
  82 \r
  83 </listitem>\r
  84 </varlistentry>\r
  85 </variablelist>\r
  86 \r
  87 </refsect1><refsect1><title>Returns</title>\r
  88 \r
  89 <para>This template returns '1' if the specified node is a section\r
  90 (Section, Sect1, Sect2, etc.), and '0' otherwise.</para>\r
  91 \r
  92 </refsect1></refentry>\r
  93 \r
  94 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="template.section.level">\r
  95 <refnamediv>\r
  96 <refname>section.level</refname>\r
  97 <refpurpose>Returns the hierarchical level of a section</refpurpose>\r
  98 </refnamediv>\r
  99 <refsynopsisdiv>\r
 100 <synopsis>&lt;xsl:template name="section.level"&gt;\r
 101 &lt;xsl:param name="node" select="."/&gt;\r
 102   ...\r
 103 &lt;/xsl:template&gt;</synopsis>\r
 104 </refsynopsisdiv>\r
 105 <refsect1><title>Description</title>\r
 106 \r
 107 <para>This template calculates the hierarchical level of a section.\r
 108 The element <tag>sect1</tag> is at level 1, <tag>sect2</tag> is\r
 109 at level 2, etc.</para>\r
 110 \r
 111 \r
 112 \r
 113 <para>Recursive sections are calculated down to the fifth level.</para>\r
 114 \r
 115 </refsect1><refsect1><title>Parameters</title>\r
 116 \r
 117 <variablelist>\r
 118 <varlistentry><term>node</term>\r
 119 <listitem>\r
 120 \r
 121 <para>The section node for which the level should be calculated.\r
 122 Defaults to the context node.</para>\r
 123 \r
 124 </listitem>\r
 125 </varlistentry>\r
 126 </variablelist>\r
 127 \r
 128 </refsect1><refsect1><title>Returns</title>\r
 129 \r
 130 <para>The section level, <quote>1</quote>, <quote>2</quote>, etc.\r
 131 </para>\r
 132 \r
 133 </refsect1></refentry>\r
 134 \r
 135 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="template.qanda.section.level">\r
 136 <refnamediv>\r
 137 <refname>qanda.section.level</refname>\r
 138 <refpurpose>Returns the hierarchical level of a QandASet</refpurpose>\r
 139 </refnamediv>\r
 140 <refsynopsisdiv>\r
 141 <synopsis>&lt;xsl:template name="qanda.section.level"/&gt;</synopsis>\r
 142 </refsynopsisdiv>\r
 143 <refsect1><title>Description</title>\r
 144 \r
 145 <para>This template calculates the hierarchical level of a QandASet.\r
 146 </para>\r
 147 \r
 148 </refsect1><refsect1><title>Returns</title>\r
 149 \r
 150 <para>The level, <quote>1</quote>, <quote>2</quote>, etc.\r
 151 </para>\r
 152 \r
 153 </refsect1></refentry>\r
 154 \r
 155 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="template.select.mediaobject">\r
 156 <refnamediv>\r
 157 <refname>select.mediaobject</refname>\r
 158 <refpurpose>Selects and processes an appropriate media object from a list</refpurpose>\r
 159 </refnamediv>\r
 160 <refsynopsisdiv>\r
 161 <synopsis>&lt;xsl:template name="select.mediaobject"&gt;\r
 162 &lt;xsl:param name="olist" select="imageobject|imageobjectco                      |videoobject|audioobject|textobject"/&gt;\r
 163   ...\r
 164 &lt;/xsl:template&gt;</synopsis>\r
 165 </refsynopsisdiv>\r
 166 <refsect1><title>Description</title>\r
 167 \r
 168 <para>This template takes a list of media objects (usually the\r
 169 children of a mediaobject or inlinemediaobject) and processes\r
 170 the "right" object.</para>\r
 171 \r
 172 \r
 173 \r
 174 <para>This template relies on a template named \r
 175 "select.mediaobject.index" to determine which object\r
 176 in the list is appropriate.</para>\r
 177 \r
 178 \r
 179 \r
 180 <para>If no acceptable object is located, nothing happens.</para>\r
 181 \r
 182 </refsect1><refsect1><title>Parameters</title>\r
 183 \r
 184 <variablelist>\r
 185 <varlistentry><term>olist</term>\r
 186 <listitem>\r
 187 \r
 188 <para>The node list of potential objects to examine.</para>\r
 189 \r
 190 </listitem>\r
 191 </varlistentry>\r
 192 </variablelist>\r
 193 \r
 194 </refsect1><refsect1><title>Returns</title>\r
 195 \r
 196 <para>Calls &lt;xsl:apply-templates&gt; on the selected object.</para>\r
 197 \r
 198 </refsect1></refentry>\r
 199 \r
 200 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="template.select.mediaobject.index">\r
 201 <refnamediv>\r
 202 <refname>select.mediaobject.index</refname>\r
 203 <refpurpose>Selects the position of the appropriate media object from a list</refpurpose>\r
 204 </refnamediv>\r
 205 <refsynopsisdiv>\r
 206 <synopsis>&lt;xsl:template name="select.mediaobject.index"&gt;\r
 207 &lt;xsl:param name="olist" select="imageobject|imageobjectco                      |videoobject|audioobject|textobject"/&gt;\r
 208 &lt;xsl:param name="count"&gt;1&lt;/xsl:param&gt;\r
 209   ...\r
 210 &lt;/xsl:template&gt;</synopsis>\r
 211 </refsynopsisdiv>\r
 212 <refsect1><title>Description</title>\r
 213 \r
 214 <para>This template takes a list of media objects (usually the\r
 215 children of a mediaobject or inlinemediaobject) and determines\r
 216 the "right" object. It returns the position of that object\r
 217 to be used by the calling template.</para>\r
 218 \r
 219 \r
 220 \r
 221 <para>If the parameter <parameter>use.role.for.mediaobject</parameter>\r
 222 is nonzero, then it first checks for an object with\r
 223 a role attribute of the appropriate value.  It takes the first\r
 224 of those.  Otherwise, it takes the first acceptable object\r
 225 through a recursive pass through the list.</para>\r
 226 \r
 227 \r
 228 \r
 229 <para>This template relies on a template named "is.acceptable.mediaobject"\r
 230 to determine if a given object is an acceptable graphic. The semantics\r
 231 of media objects is that the first acceptable graphic should be used.\r
 232 </para>\r
 233 \r
 234 \r
 235 \r
 236 <para>If no acceptable object is located, no index is returned.</para>\r
 237 \r
 238 </refsect1><refsect1><title>Parameters</title>\r
 239 \r
 240 <variablelist>\r
 241 <varlistentry><term>olist</term>\r
 242 <listitem>\r
 243 \r
 244 <para>The node list of potential objects to examine.</para>\r
 245 \r
 246 </listitem>\r
 247 </varlistentry>\r
 248 <varlistentry><term>count</term>\r
 249 <listitem>\r
 250 \r
 251 <para>The position in the list currently being considered by the \r
 252 recursive process.</para>\r
 253 \r
 254 </listitem>\r
 255 </varlistentry>\r
 256 </variablelist>\r
 257 \r
 258 </refsect1><refsect1><title>Returns</title>\r
 259 \r
 260 <para>Returns the position in the original list of the selected object.</para>\r
 261 \r
 262 </refsect1></refentry>\r
 263 \r
 264 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="template.is.acceptable.mediaobject">\r
 265 <refnamediv>\r
 266 <refname>is.acceptable.mediaobject</refname>\r
 267 <refpurpose>Returns '1' if the specified media object is recognized</refpurpose>\r
 268 </refnamediv>\r
 269 <refsynopsisdiv>\r
 270 <synopsis>&lt;xsl:template name="is.acceptable.mediaobject"&gt;\r
 271 &lt;xsl:param name="object"/&gt;\r
 272   ...\r
 273 &lt;/xsl:template&gt;</synopsis>\r
 274 </refsynopsisdiv>\r
 275 <refsect1><title>Description</title>\r
 276 \r
 277 <para>This template examines a media object and returns '1' if the\r
 278 object is recognized as a graphic.</para>\r
 279 \r
 280 </refsect1><refsect1><title>Parameters</title>\r
 281 \r
 282 <variablelist>\r
 283 <varlistentry><term>object</term>\r
 284 <listitem>\r
 285 \r
 286 <para>The media object to consider.</para>\r
 287 \r
 288 </listitem>\r
 289 </varlistentry>\r
 290 </variablelist>\r
 291 \r
 292 </refsect1><refsect1><title>Returns</title>\r
 293 \r
 294 <para>0 or 1</para>\r
 295 \r
 296 </refsect1></refentry>\r
 297 \r
 298 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="template.check.id.unique">\r
 299 <refnamediv>\r
 300 <refname>check.id.unique</refname>\r
 301 <refpurpose>Warn users about references to non-unique IDs</refpurpose>\r
 302 </refnamediv>\r
 303 <refsynopsisdiv>\r
 304 <synopsis>&lt;xsl:template name="check.id.unique"&gt;\r
 305 &lt;xsl:param name="linkend"/&gt;\r
 306   ...\r
 307 &lt;/xsl:template&gt;</synopsis>\r
 308 </refsynopsisdiv>\r
 309 <refsect1><title>Description</title>\r
 310 \r
 311 <para>If passed an ID in <varname>linkend</varname>,\r
 312 <function>check.id.unique</function> prints\r
 313 a warning message to the user if either the ID does not exist or\r
 314 the ID is not unique.</para>\r
 315 \r
 316 </refsect1></refentry>\r
 317 \r
 318 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="template.check.idref.targets">\r
 319 <refnamediv>\r
 320 <refname>check.idref.targets</refname>\r
 321 <refpurpose>Warn users about incorrectly typed references</refpurpose>\r
 322 </refnamediv>\r
 323 <refsynopsisdiv>\r
 324 <synopsis>&lt;xsl:template name="check.idref.targets"&gt;\r
 325 &lt;xsl:param name="linkend"/&gt;\r
 326 &lt;xsl:param name="element-list"/&gt;\r
 327   ...\r
 328 &lt;/xsl:template&gt;</synopsis>\r
 329 </refsynopsisdiv>\r
 330 <refsect1><title>Description</title>\r
 331 \r
 332 <para>If passed an ID in <varname>linkend</varname>,\r
 333 <function>check.idref.targets</function> makes sure that the element\r
 334 pointed to by the link is one of the elements listed in\r
 335 <varname>element-list</varname> and warns the user otherwise.</para>\r
 336 \r
 337 </refsect1></refentry>\r
 338 \r
 339 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="template.copyright.years">\r
 340 <refnamediv>\r
 341 <refname>copyright.years</refname>\r
 342 <refpurpose>Print a set of years with collapsed ranges</refpurpose>\r
 343 </refnamediv>\r
 344 <refsynopsisdiv>\r
 345 <synopsis>&lt;xsl:template name="copyright.years"&gt;\r
 346 &lt;xsl:param name="years"/&gt;\r
 347 &lt;xsl:param name="print.ranges" select="1"/&gt;\r
 348 &lt;xsl:param name="single.year.ranges" select="0"/&gt;\r
 349 &lt;xsl:param name="firstyear" select="0"/&gt;\r
 350 &lt;xsl:param name="nextyear" select="0"/&gt;\r
 351   ...\r
 352 &lt;/xsl:template&gt;</synopsis>\r
 353 </refsynopsisdiv>\r
 354 <refsect1><title>Description</title>\r
 355 \r
 356 <para>This template prints a list of year elements with consecutive\r
 357 years printed as a range. In other words:</para>\r
 358 \r
 359 \r
 360 <screen>&lt;year&gt;1992&lt;/year&gt;\r
 361 &lt;year&gt;1993&lt;/year&gt;\r
 362 &lt;year&gt;1994&lt;/year&gt;</screen>\r
 363 \r
 364 \r
 365 <para>is printed <quote>1992-1994</quote>, whereas:</para>\r
 366 \r
 367 \r
 368 <screen>&lt;year&gt;1992&lt;/year&gt;\r
 369 &lt;year&gt;1994&lt;/year&gt;</screen>\r
 370 \r
 371 \r
 372 <para>is printed <quote>1992, 1994</quote>.</para>\r
 373 \r
 374 \r
 375 \r
 376 <para>This template assumes that all the year elements contain only\r
 377 decimal year numbers, that the elements are sorted in increasing\r
 378 numerical order, that there are no duplicates, and that all the years\r
 379 are expressed in full <quote>century+year</quote>\r
 380 (<quote>1999</quote> not <quote>99</quote>) notation.</para>\r
 381 \r
 382 </refsect1><refsect1><title>Parameters</title>\r
 383 \r
 384 <variablelist>\r
 385 <varlistentry><term>years</term>\r
 386 <listitem>\r
 387 \r
 388 <para>The initial set of year elements.</para>\r
 389 \r
 390 </listitem>\r
 391 </varlistentry>\r
 392 <varlistentry><term>print.ranges</term>\r
 393 <listitem>\r
 394 \r
 395 <para>If non-zero, multi-year ranges are collapsed. If zero, all years\r
 396 are printed discretely.</para>\r
 397 \r
 398 </listitem>\r
 399 </varlistentry>\r
 400 <varlistentry><term>single.year.ranges</term>\r
 401 <listitem>\r
 402 \r
 403 <para>If non-zero, two consecutive years will be printed as a range,\r
 404 otherwise, they will be printed discretely. In other words, a single\r
 405 year range is <quote>1991-1992</quote> but discretely it's\r
 406 <quote>1991, 1992</quote>.</para>\r
 407 \r
 408 </listitem>\r
 409 </varlistentry>\r
 410 </variablelist>\r
 411 \r
 412 </refsect1><refsect1><title>Returns</title>\r
 413 \r
 414 <para>This template returns the formatted list of years.</para>\r
 415 \r
 416 </refsect1></refentry>\r
 417 \r
 418 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="template.find.path.params">\r
 419 <refnamediv>\r
 420 <refname>find.path.params</refname>\r
 421 <refpurpose>Search in a table for the "best" match for the node</refpurpose>\r
 422 </refnamediv>\r
 423 <refsynopsisdiv>\r
 424 <synopsis>&lt;xsl:template name="find.path.params"&gt;\r
 425 &lt;xsl:param name="node" select="."/&gt;\r
 426 &lt;xsl:param name="table" select="''"/&gt;\r
 427 &lt;xsl:param name="location"&gt;\r
 428     &lt;xsl:call-template name="xpath.location"&gt;\r
 429       &lt;xsl:with-param name="node" select="$node"/&gt;\r
 430     &lt;/xsl:call-template&gt;\r
 431   &lt;/xsl:param&gt;\r
 432   ...\r
 433 &lt;/xsl:template&gt;</synopsis>\r
 434 </refsynopsisdiv>\r
 435 <refsect1><title>Description</title>\r
 436 \r
 437 <para>This template searches in a table for the value that most-closely\r
 438 (in the typical best-match sense of XSLT) matches the current (element)\r
 439 node location.</para>\r
 440 \r
 441 </refsect1></refentry>\r
 442 \r
 443 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="template.string.upper">\r
 444 <refnamediv>\r
 445 <refname>string.upper</refname>\r
 446 <refpurpose>Converts a string to all uppercase letters</refpurpose>\r
 447 </refnamediv>\r
 448 <refsynopsisdiv>\r
 449 <synopsis>&lt;xsl:template name="string.upper"&gt;\r
 450 &lt;xsl:param name="string" select="''"/&gt;\r
 451   ...\r
 452 &lt;/xsl:template&gt;</synopsis>\r
 453 </refsynopsisdiv>\r
 454 <refsect1><title>Description</title>\r
 455 \r
 456 <para>Given a string, this template does a language-aware conversion\r
 457 of that string to all uppercase letters, based on the values of the\r
 458 <literal>lowercase.alpha</literal> and\r
 459 <literal>uppercase.alpha</literal> gentext keys for the current\r
 460 locale. It affects only those characters found in the values of\r
 461 <literal>lowercase.alpha</literal> and\r
 462 <literal>uppercase.alpha</literal>. All other characters are left\r
 463 unchanged.</para>\r
 464 \r
 465 </refsect1><refsect1><title>Parameters</title>\r
 466 \r
 467 <variablelist>\r
 468 <varlistentry><term>string</term>\r
 469 <listitem>\r
 470 \r
 471 <para>The string to convert to uppercase.</para>\r
 472 \r
 473 </listitem>\r
 474 </varlistentry>\r
 475 </variablelist>\r
 476 \r
 477 </refsect1></refentry>\r
 478 \r
 479 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="template.string.lower">\r
 480 <refnamediv>\r
 481 <refname>string.lower</refname>\r
 482 <refpurpose>Converts a string to all lowercase letters</refpurpose>\r
 483 </refnamediv>\r
 484 <refsynopsisdiv>\r
 485 <synopsis>&lt;xsl:template name="string.lower"&gt;\r
 486 &lt;xsl:param name="string" select="''"/&gt;\r
 487   ...\r
 488 &lt;/xsl:template&gt;</synopsis>\r
 489 </refsynopsisdiv>\r
 490 <refsect1><title>Description</title>\r
 491 \r
 492 <para>Given a string, this template does a language-aware conversion\r
 493 of that string to all lowercase letters, based on the values of the\r
 494 <literal>uppercase.alpha</literal> and\r
 495 <literal>lowercase.alpha</literal> gentext keys for the current\r
 496 locale. It affects only those characters found in the values of\r
 497 <literal>uppercase.alpha</literal> and\r
 498 <literal>lowercase.alpha</literal>. All other characters are left\r
 499 unchanged.</para>\r
 500 \r
 501 </refsect1><refsect1><title>Parameters</title>\r
 502 \r
 503 <variablelist>\r
 504 <varlistentry><term>string</term>\r
 505 <listitem>\r
 506 \r
 507 <para>The string to convert to lowercase.</para>\r
 508 \r
 509 </listitem>\r
 510 </varlistentry>\r
 511 </variablelist>\r
 512 \r
 513 </refsect1></refentry>\r
 514 \r
 515 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="template.select.choice.separator">\r
 516 <refnamediv>\r
 517 <refname>select.choice.separator</refname>\r
 518 <refpurpose>Returns localized choice separator</refpurpose>\r
 519 </refnamediv>\r
 520 <refsynopsisdiv>\r
 521 <synopsis>&lt;xsl:template name="select.choice.separator"/&gt;</synopsis>\r
 522 </refsynopsisdiv>\r
 523 <refsect1><title>Description</title>\r
 524     \r
 525 <para>This template enables auto-generation of an appropriate\r
 526     localized "choice" separator (for example, "and" or "or") before\r
 527     the final item in an inline list (though it could also be useful\r
 528     for generating choice separators for non-inline lists).</para>\r
 529 \r
 530     \r
 531 <para>It currently works by evaluating a processing instruction\r
 532     (PI) of the form &lt;?dbchoice choice="foo"?&gt; :\r
 533     \r
 534 <itemizedlist>\r
 535       <listitem>\r
 536         <simpara>if the value of the <tag>choice</tag>\r
 537         pseudo-attribute is "and" or "or", returns a localized "and"\r
 538         or "or"</simpara>\r
 539       </listitem>\r
 540       <listitem>\r
 541         <simpara>otherwise returns the literal value of the\r
 542         <tag>choice</tag> pseudo-attribute</simpara>\r
 543       </listitem>\r
 544     </itemizedlist>\r
 545 \r
 546     The latter is provided only as a temporary workaround because the\r
 547     locale files do not currently have translations for the word\r
 548     <wordasword>or</wordasword>. So if you want to generate a a\r
 549     logical "or" separator in French (for example), you currently need\r
 550     to do this:\r
 551     <literallayout>&lt;?dbchoice choice="ou"?&gt;</literallayout>\r
 552     </para>\r
 553 \r
 554     <warning>\r
 555       \r
 556 <para>The <tag>dbchoice</tag> processing instruction is\r
 557       an unfortunate hack; support for it may disappear in the future\r
 558       (particularly if and when a more appropriate means for marking\r
 559       up "choice" lists becomes available in DocBook).</para>\r
 560 \r
 561     </warning>\r
 562   </refsect1></refentry>\r
 563 \r
 564 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="template.evaluate.info.profile">\r
 565 <refnamediv>\r
 566 <refname>evaluate.info.profile</refname>\r
 567 <refpurpose>Evaluates an info profile</refpurpose>\r
 568 </refnamediv>\r
 569 <refsynopsisdiv>\r
 570 <synopsis>&lt;xsl:template name="evaluate.info.profile"&gt;\r
 571 &lt;xsl:param name="profile"/&gt;\r
 572 &lt;xsl:param name="info"/&gt;\r
 573   ...\r
 574 &lt;/xsl:template&gt;</synopsis>\r
 575 </refsynopsisdiv>\r
 576 <refsect1><title>Description</title>\r
 577     \r
 578 <para>This template evaluates an "info profile" matching the XPath\r
 579     expression given by the <parameter>profile</parameter>\r
 580     parameter. It relies on the XSLT <function>evaluate()</function>\r
 581     extension function.</para>\r
 582 \r
 583 \r
 584     \r
 585 <para>The value of the <parameter>profile</parameter> parameter\r
 586     can include the literal string <literal>$info</literal>. If found\r
 587     in the value of the <parameter>profile</parameter> parameter, the\r
 588     literal string <literal>$info</literal> string is replaced with\r
 589     the value of the <parameter>info</parameter> parameter, which\r
 590     should be a set of <replaceable>*info</replaceable> nodes; the\r
 591     expression is then evaluated using the XSLT\r
 592     <function>evaluate()</function> extension function.</para>\r
 593 \r
 594   </refsect1><refsect1><title>Parameters</title>\r
 595     \r
 596 <variablelist>\r
 597        <varlistentry>\r
 598         <term>profile</term>\r
 599         <listitem>\r
 600           \r
 601 <para>A string representing an XPath expression </para>\r
 602 \r
 603         </listitem>\r
 604       </varlistentry>\r
 605        <varlistentry>\r
 606         <term>info</term>\r
 607         <listitem>\r
 608           \r
 609 <para>A set of *info nodes</para>\r
 610 \r
 611         </listitem>\r
 612       </varlistentry>\r
 613     </variablelist>\r
 614 \r
 615   </refsect1><refsect1><title>Returns</title>\r
 616     \r
 617 <para>Returns a node (the result of evaluating the\r
 618     <parameter>profile</parameter> parameter)</para>\r
 619 \r
 620   </refsect1></refentry>\r
 621 </reference>\r
 622 \r