show.revisionflag.xml 1.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142
  1. <refentry xmlns="http://docbook.org/ns/docbook"
  2. xmlns:xlink="http://www.w3.org/1999/xlink"
  3. xmlns:xi="http://www.w3.org/2001/XInclude"
  4. xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
  5. xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  6. version="5.0" xml:id="show.revisionflag">
  7. <refmeta>
  8. <refentrytitle>show.revisionflag</refentrytitle>
  9. <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
  10. </refmeta>
  11. <refnamediv>
  12. <refname>show.revisionflag</refname>
  13. <refpurpose>Enable decoration of elements that have a revisionflag</refpurpose>
  14. </refnamediv>
  15. <refsynopsisdiv>
  16. <src:fragment xml:id="show.revisionflag.frag">
  17. <xsl:param name="show.revisionflag" select="0"/>
  18. </src:fragment>
  19. </refsynopsisdiv>
  20. <refsection><info><title>Description</title></info>
  21. <para>
  22. If <parameter>show.revisionflag</parameter> is turned on, then the stylesheets
  23. may produce additional markup designed to allow a CSS stylesheet to
  24. highlight elements that have specific revisionflag settings.</para>
  25. <para>The markup inserted will be usually be either a &lt;span&gt; or
  26. &lt;div&gt; with an appropriate <literal>class</literal>
  27. attribute. (The value of the class attribute will be the same as the
  28. value of the revisionflag attribute). In some contexts, for example
  29. tables, where extra markup would be structurally illegal, the class
  30. attribute will be added to the appropriate container element.</para>
  31. <para>In general, the stylesheets only test for revisionflag in contexts
  32. where an importing stylesheet would have to redefine whole templates.
  33. Most of the revisionflag processing is expected to be done by another
  34. stylesheet, for example <filename>changebars.xsl</filename>.</para>
  35. </refsection>
  36. </refentry>