+++ /dev/null
-<refentry xmlns="http://docbook.org/ns/docbook"\r
- xmlns:xlink="http://www.w3.org/1999/xlink"\r
- xmlns:xi="http://www.w3.org/2001/XInclude"\r
- xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"\r
- xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
- version="5.0" xml:id="profile.role">\r
-<refmeta>\r
-<refentrytitle>profile.role</refentrytitle>\r
-<refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
-</refmeta>\r
-<refnamediv>\r
-<refname>profile.role</refname>\r
-<refpurpose>Target profile for <tag class="attribute">role</tag>\r
-attribute</refpurpose>\r
-</refnamediv>\r
-\r
-<refsynopsisdiv>\r
-<src:fragment xml:id="profile.role.frag">\r
-<xsl:param name="profile.role"></xsl:param>\r
-</src:fragment>\r
-</refsynopsisdiv>\r
-\r
-<refsection><info><title>Description</title></info>\r
-\r
-<para>The value of this parameter specifies profiles which should be\r
-included in the output. You can specify multiple profiles by\r
-separating them by semicolon. You can change separator character by\r
-<parameter>profile.separator</parameter>\r
-parameter.</para>\r
-\r
-<para>This parameter has effect only when you are using profiling\r
-stylesheets (<filename>profile-docbook.xsl</filename>,\r
-<filename>profile-chunk.xsl</filename>, …) instead of normal\r
-ones (<filename>docbook.xsl</filename>,\r
-<filename>chunk.xsl</filename>, …).</para>\r
-\r
-<warning>\r
-<para>Note that <tag class="attribute">role</tag> is often\r
-used for other purposes than profiling. For example it is commonly\r
-used to get emphasize in bold font:</para>\r
-\r
-<programlisting><emphasis role="bold">very important</emphasis></programlisting>\r
-\r
-<para>If you are using <tag class="attribute">role</tag> for\r
-these purposes do not forget to add values like <literal>bold</literal> to\r
-value of this parameter. If you forgot you will get document with\r
-small pieces missing which are very hard to track.</para>\r
-\r
-<para>For this reason it is not recommended to use <tag class="attribute">role</tag> attribute for profiling. You should\r
-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
-</warning>\r
-\r
-</refsection>\r
-</refentry>\r