docbook-tc — archive

[Robert Stayton]

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