keycap proposal

[Bob Stayton <bobs@sco.com>]

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