OASIS DocBook TC2

 View Only
  • 1.  keycap proposal

    Posted 06-16-2003 21:36
    I'm following up on one of my action items, this one
    to develop a concrete proposal for semantic keycaps,
    in response to RFE 697374.
    
    The RFE pointed out that while a keycap
    element can contain text that indicates the marks
    on the top of the key, there are some keys that
    are special because they perform a function, such
    as Ctrl, Shift, Alt, etc.  It would be better to capture
    the semantic function of such special keys, so that they
    can be rendered by a stylesheet in an appropriate manner
    or language.  Examples: Ctrl-H,  C-h (Emacs), Strg-H (German).
    
    The simplest solution is to add a 'function' attribute
    with enumerated values to the keycap element.  The most
    common keys would be enumerated, but it is not possible
    to list all possible function keys.  So one of the
    enumerated values would be 'other', which would indicate
    that another new CDATA attribute 'otherfunction' should be used.
    This is similar to the 'action' attribute of the keycombo element.
    
    So the proposed new attributes for keycap are:
    
    function     (alt
                 |control
                 |shift
    	     |escape
    	     |enter
    	     |tab
    	     |backspace
    	     |command
    	     |option
    	     |space
    	     |delete
    	     |insert
    	     |up
    	     |down
    	     |left
    	     |right
    	     |meta
    	     |home
    	     |end
    	     |pageup
    	     |pagedown
    	     |other)        #IMPLIED
    
    otherfunction  CDATA        #IMPLIED
    
    
    Bob Stayton                                 400 Encinal Street
    Publications Architect                      Santa Cruz, CA  95060
    Technical Publications                      voice: (831) 427-7796
    The SCO Group                               fax:   (831) 429-1887
                                                email: bobs@sco.com