</refmeta>
<refnamediv>
<refname>generate.meta.abstract</refname>
-<refpurpose>Generate HTML <tag>META</tag> element from <tag>abstract</tag>?</refpurpose>
+<refpurpose>Generate HTML <tag role="html">META</tag> element from <tag>abstract</tag>?</refpurpose>
</refnamediv>
<refsynopsisdiv>
<refsection><info><title>Description</title></info>
<para>If non-zero, document abstracts will be reproduced in the HTML
-<tag>HEAD</tag> with <tag class="starttag">meta name="description" content="..."</tag>.</para>
+<tag role="html">HEAD</tag> with <tag class="starttag">meta name="description" content="..."</tag>.</para>
</refsection>
</refentry>
</refmeta>
<refnamediv>
<refname>index.on.type</refname>
-<refpurpose>Select indexterms based on <tag>type</tag>
+<refpurpose>Select indexterms based on <tag class="attribute">type</tag>
attribute value</refpurpose>
</refnamediv>
<para>
If non-zero,
then an <tag>index</tag> element that has a
-<tag>type</tag> attribute
+<tag class="attribute">type</tag> attribute
value will contain only those <tag>indexterm</tag>
elements with a matching <tag>type</tag> attribute value.
-If an <tag>index</tag> has no <tag>type</tag>
+If an <tag>index</tag> has no <tag class="attribute">type</tag>
attribute or it is blank, then the index will contain
all <tag>indexterm</tag>s in the current scope.
</para>
<para>
If <literal>index.on.type</literal> is zero, then the
-<tag>type</tag> attribute has no effect
+<tag class="attribute">type</tag> attribute has no effect
on selecting indexterms for an index.
</para>
<para>For those using DocBook version 4.2 or earlier,
the <tag>type</tag> attribute is not available
for index terms. However, you can achieve the same
-effect by using the <tag>role</tag> attribute
+effect by using the <tag class="attribute">role</tag> attribute
in the same manner on <tag>indexterm</tag>
and <tag>index</tag>, and setting the stylesheet parameter
<parameter>index.on.role</parameter> to a nonzero value.
</refmeta>
<refnamediv>
<refname>use.embed.for.svg</refname>
-<refpurpose>Use HTML <tag>embed</tag> for SVG?</refpurpose>
+<refpurpose>Use HTML <tag role="html">embed</tag> for SVG?</refpurpose>
</refnamediv>
<refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If non-zero, an <tag>embed</tag> element will be created for
-SVG figures. An <tag>object</tag> is <emphasis>always</emphasis> created,
-this parameter merely controls whether or not an additional <tag>embed</tag>
-is generated inside the <tag>object</tag>.</para>
+<para>If non-zero, an <tag role="html">embed</tag> element will be created for
+SVG figures. An <tag role="html">object</tag> is <emphasis>always</emphasis> created,
+this parameter merely controls whether or not an additional <tag role="html">embed</tag>
+is generated inside the <tag role="html">object</tag>.</para>
<para>On the plus side, this may be more portable among browsers and plug-ins.
On the minus side, it isn't valid HTML.</para>