Can I get a +1 for this case? (There were no comments from the X.Org
side either, so this is going ahead.)
-alan-
Alan Coopersmith wrote:
> I am sponsoring this fasttrack for myself. This change is being
> submitted today both to LSARC for review and to the X.Org community
> for their review, so may be changed due to feedback from either side -
> it will not be integrated until both reviews are satisfied. If both
> accept, then this would appear in X11R7.5 and in future releases of
> OpenSolaris & Solaris.
>
> -Alan Coopersmith- alan.coopersmith at sun.com
> Sun Microsystems, Inc. - X Window System Engineering
>
>
> Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI
> This information is Copyright 2009 Sun Microsystems
> 1. Introduction
> 1.1. Project/Component Working Name:
> xset support for XKB indicator names
> 1.2. Name of Document Author/Supplier:
> Author: Alan Coopersmith
> 1.3 Date of This Document:
> 16 June, 2009
> 4. Technical Description
>
> This case adds support to the xset command to set & get led states using
> XKB indicator names, in addition to the numbers xset already supports.
>
> If the X server supports the XKEYBOARD (XKB) extension, "xset q" is extended
> to display a list of XKB indicators after the LED mask. Example output
> when run against the Xnewt server on my desktop Sun Ray:
>
> Keyboard Control:
> auto repeat: on key click percent: 0 LED mask: 00000002
> XKB indicators:
> 00: Caps Lock: off 01: Num Lock: on 02: Scroll Lock: off
> 03: Compose: off 04: Shift Lock: off 05: Group 2: off
> 06: Mouse Keys: off
> auto repeat delay: 600 repeat rate: 30
> auto repeating keys: 00ffffffdffffbbf
> fadfffffffdfe5ff
> ffffffffffffffff
> ffffffffffffffff
> bell percent: 50 bell pitch: 400 bell duration: 100
> [...]
>
> XKB indicators include both leds physically on a keyboard and virtual
> state indicators which may be displayed by other clients, such as
> input method or accessibility helper status displays.
>
> To set indicators on or off, the led option to xset is extended to accept
> the keyword "named" followed by a required argument for the indicator name
> to set. (Unfortunately due to the existing/historic/horrible xset syntax,
> and the free-form naming possibility of XKB indicators, the named keyword
> is necessary to avoid ambiguity if an indicator had a name that could be
> confused with an existing argument that doesn't begin with a '-'.)
>
> Man page diffs:
>
> --- a/xset.man
> +++ b/xset.man
> @@ -51,8 +51,8 @@ xset - user preference utility for X
> .br
> [fp default] [fp rehash]
> .br
> -[-led [\fIinteger\fP]]
> -[led [\fIinteger\fP]]
> +[-led [\fIinteger\fP|named \fIindicator\fP]]
> +[led [\fIinteger\fP|named \fIindicator\fP]]
> .br
> [led {on|off}]
> .br
> @@ -176,10 +176,14 @@
> If a preceding dash or the flag 'off' is given, all LEDs are turned off.
> If a value between 1 and 32 is given, that LED will be turned on or off
> depending on the existence of a preceding dash.
> -A common LED which can be controlled is the ``Caps Lock'' LED. ``xset
> -led 3'' would turn led #3 on. ``xset -led 3'' would turn it off.
> +``xset led 3'' would turn led #3 on. ``xset -led 3'' would turn it off.
> The particular LED values may refer to different LEDs on different
> hardware.
> +If the X server supports the XKEYBOARD (XKB) extension, leds may be
> +referenced by the XKB indicator name by specifying the `named' keyword
> +and the indicator name. For example, to turn on the Scroll Lock LED:
> +.IP
> +xset led named "Scroll Lock"
> .PP
> .TP 8
> .B mouse
>
> [Note there is a typo in the currently delivered man page claiming that
> the argument to turn on leds starts with a + - but the command does not
> accept that syntax and requires a bare "led" keyword there. That bug
> in the man page will be fixed along with this change.]
>
> Interfaces Exported:
> --------------------
> xset led named <name> Committed
> xset -led named <name> Committed
> xset q output format Not-An-Interface
>
> 6. Resources and Schedule
> 6.4. Steering Committee requested information
> 6.4.1. Consolidation C-team Name:
> X Consolidation / Desktop C-Team
> 6.5. ARC review type: FastTrack
> 6.6. ARC Exposure: open
>
--
-Alan Coopersmith- alan.coopersmith at sun.com
Sun Microsystems, Inc. - X Window System Engineering
