stylesheets/evergreen_docbook_files/docbook-xsl-1.75.2/params/profile.role.xml

   1 <refentry xmlns="http://docbook.org/ns/docbook"\r
   2           xmlns:xlink="http://www.w3.org/1999/xlink"\r
   3           xmlns:xi="http://www.w3.org/2001/XInclude"\r
   4           xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"\r
   5           xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
   6           version="5.0" xml:id="profile.role">\r
   7 <refmeta>\r
   8 <refentrytitle>profile.role</refentrytitle>\r
   9 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
  10 </refmeta>\r
  11 <refnamediv>\r
  12 <refname>profile.role</refname>\r
  13 <refpurpose>Target profile for <tag class="attribute">role</tag>\r
  14 attribute</refpurpose>\r
  15 </refnamediv>\r
  16 \r
  17 <refsynopsisdiv>\r
  18 <src:fragment xml:id="profile.role.frag">\r
  19 <xsl:param name="profile.role"></xsl:param>\r
  20 </src:fragment>\r
  21 </refsynopsisdiv>\r
  22 \r
  23 <refsection><info><title>Description</title></info>\r
  24 \r
  25 <para>The value of this parameter specifies profiles which should be\r
  26 included in the output. You can specify multiple profiles by\r
  27 separating them by semicolon. You can change separator character by\r
  28 <parameter>profile.separator</parameter>\r
  29 parameter.</para>\r
  30 \r
  31 <para>This parameter has effect only when you are using profiling\r
  32 stylesheets (<filename>profile-docbook.xsl</filename>,\r
  33 <filename>profile-chunk.xsl</filename>, …) instead of normal\r
  34 ones (<filename>docbook.xsl</filename>,\r
  35 <filename>chunk.xsl</filename>, …).</para>\r
  36 \r
  37 <warning>\r
  38 <para>Note that <tag class="attribute">role</tag> is often\r
  39 used for other purposes than profiling. For example it is commonly\r
  40 used to get emphasize in bold font:</para>\r
  41 \r
  42 <programlisting>&lt;emphasis role="bold"&gt;very important&lt;/emphasis&gt;</programlisting>\r
  43 \r
  44 <para>If you are using <tag class="attribute">role</tag> for\r
  45 these purposes do not forget to add values like <literal>bold</literal> to\r
  46 value of this parameter. If you forgot you will get document with\r
  47 small pieces missing which are very hard to track.</para>\r
  48 \r
  49 <para>For this reason it is not recommended to use <tag class="attribute">role</tag> attribute for profiling. You should\r
  50 rather use profiling specific attributes like <tag class="attribute">userlevel</tag>, <tag class="attribute">os</tag>, <tag class="attribute">arch</tag>, <tag class="attribute">condition</tag>, etc.</para>\r
  51 </warning>\r
  52 \r
  53 </refsection>\r
  54 </refentry>\r