DocBook V5.0 Removed Elements--second draft

["Dick Hamilton" <rlhamilton@frii.com>]

Based on the feedback in email and at the TC meeting, here is a revised
version of the recommendation on how authors can map the removed
elements.
This content will end up in the DocBook V5.0 How-to as a table.

I believe I have captured the changes discussed in email and in the TC
meeting; if not, or if anyone has additional feedback, please let me
know.
I plan to complete this by the middle of next week unless there are
major
concerns that need to be addressed.

Dick Hamilton
rlhamilton@frii.com
========================================================================
======
The following elements were removed from DocBook V5.0 without direct
replacements: action, beginpage, highlights, interface, invpartnumber,
medialabel, modespec, structfield, structname. If you use one or more
of these elements, here are some suggestions as to how to re-code them
in DocBook V5.0.

Table 2. Recommended mapping for removed elements


Old name	    Recommended mapping
action	    Use <phrase remap="action">.
beginpage       Remove: beginpage is advisory only and has tended to
                cause confusion. A processing instruction or comment
                should be a workable replacement if one is needed.
highlights	    Use abstract. Note that because highlights has a
broader
                content model, you may need to wrap contents in a para
                inside abstract
interface       Use one of the "gui" elements (guibutton, guiicon,
                guilabel, guimenu, guimenuitem, or guisubmenu)
invpartnumber   Use <biblioid class="other" otherclass="medialabel">.
                The productnumber element is another alternative.
medialabel      Use <citetitle pubwork="mediatype">, where mediatype
                is the type of media being labeled (e.g., cdrom or dvd).
modespec        No longer needed. The current processing model for olink
                renders modespec unnecessary.
structfield,    Use varname. If you need to distinguish between the two,
structname      use <varname remap="structname or structfield">.