OASIS DocBook TC2

DocBook V5.0 Removed Elements--second draft

  • 1.  DocBook V5.0 Removed Elements--second draft

    Posted 02-17-2006 19:03
     MHonArc v2.5.0b2 -->
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    docbook-tc message

    [Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


    Subject: DocBook V5.0 Removed Elements--second draft


    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">.
    
    
    


    [Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]