Re: [docbook-tc] Re: RFE 3107140

From
Norman Walsh <>
Date
2011-06-24T10:56:31+00:00
ID
Thread
Re: [docbook-tc] Re: RFE 3107140
Jirka Kosek <> writes:
>
> Well, then description is outdated, it was not simply updated.

Ah. My bad. How's this?

<refsection condition="ref.description">
<title>Description</title>

<para>The <tag>alt</tag> element was originally added to DocBook to
provide an alternative, usually text, presentation for graphical
elements. In DocBook V5.0, it was made a “ubiquitous” element so that
it's available almost everywhere. The semantic intent of
<tag>alt</tag> is simply that it provides alternative text, often for
accessibility.</para>

<refsection>
<title>Processing expectations</title>

<para>May be formatted inline or as a displayed block, depending on
context. It is not usually rendered where it occurs, rather it is used
to annotate some other aspect of the presentation.</para>

<para>For example, in an HTML presentation, the <tag>alt</tag> for a
media object would likely provide the text of the
<tag class="attribute">alt</tag> attribute for the HTML
<tag namespace="http://www.w3.org/1999/xhtml">img</tag> element.</para>

<para>In the context of an <tag>acronym</tag>, the <tag>alt</tag> could
provide the <tag class="attribute">title</tag> attribute for the HTML
<tag namespace="http://www.w3.org/1999/xhtml">phrase</tag>, commonly presented
as a “tooltip” in visual browsers.</para>

</refsection>

Better? And does this provide a satisfactory close for 3107140?

                                        Be seeing you,
                                          norm

-- 
Norman Walsh <>      | True peace is not merely the
http://www.oasis-open.org/docbook/ | absence of tension: it is the
Chair, DocBook Technical Committee | presence of justice.--Martin
                                   | Luther King