From alanc@sac.sfbay.sun.com Tue Jun 16 14:32:55 2009 Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n5GLWtdl003871 for ; Tue, 16 Jun 2009 14:32:55 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n5GLWfx5036205; Tue, 16 Jun 2009 15:32:55 -0600 (MDT) Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0KLC00J5HP6ULU00@brm-avmta-1.central.sun.com>; Tue, 16 Jun 2009 15:32:54 -0600 (MDT) Received: from dm-sfbay-02.sfbay.sun.com ([129.146.11.31]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KLC00LJZP6NC3E0@brm-avmta-1.central.sun.com>; Tue, 16 Jun 2009 15:32:47 -0600 (MDT) Received: from sac.sfbay.sun.com (sac.SFBay.Sun.COM [129.146.226.132]) by dm-sfbay-02.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n5GLWkS4053760; Tue, 16 Jun 2009 14:32:47 -0700 (PDT) Received: from sac.sfbay.sun.com (localhost [127.0.0.1]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n5GLWjCe003866; Tue, 16 Jun 2009 14:32:45 -0700 (PDT) Received: (from alanc@localhost) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id n5GLWj4V003862; Tue, 16 Jun 2009 14:32:45 -0700 (PDT) Date: Tue, 16 Jun 2009 14:32:45 -0700 (PDT) From: Alan Coopersmith Subject: xset support for XKB indicator names [LSARC/2009/361 FastTrack timeout 06/23/2009] To: LSARC-ext@sun.com Cc: xwin-discuss@opensolaris.org Message-id: <200906162132.n5GLWj4V003862@sac.sfbay.sun.com> Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 Status: RO Content-Length: 4086 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@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 Committed xset -led named 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 From Alan.Coopersmith@sun.com Fri Jun 26 07:50:45 2009 Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n5QEojDa012608 for ; Fri, 26 Jun 2009 07:50:45 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n5QEogS8027522 for <@sunmail2sca.sfbay.sun.com:LSARC-ext@sun.com>; Fri, 26 Jun 2009 08:50:45 -0600 (MDT) Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0KLU0030NP8KNM00@nwk-avmta-2.sfbay.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Fri, 26 Jun 2009 07:50:44 -0700 (PDT) Received: from sca-es-mail-2.sun.com ([192.18.43.133]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KLU00EE8P8JYDB0@nwk-avmta-2.sfbay.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Fri, 26 Jun 2009 07:50:43 -0700 (PDT) Received: from fe-sfbay-10.sun.com ([192.18.43.129]) by sca-es-mail-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id n5QEohKM020098 for ; Fri, 26 Jun 2009 07:50:43 -0700 (PDT) Received: from conversion-daemon.fe-sfbay-10.sun.com by fe-sfbay-10.sun.com (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009)) id <0KLU00C00P85J500@fe-sfbay-10.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Fri, 26 Jun 2009 07:50:43 -0700 (PDT) Received: from [10.6.102.27] ([unknown] [10.6.102.27]) by fe-sfbay-10.sun.com (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009)) with ESMTPSA id <0KLU00ARMP8JUN60@fe-sfbay-10.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Fri, 26 Jun 2009 07:50:43 -0700 (PDT) Date: Fri, 26 Jun 2009 07:50:43 -0700 From: Alan Coopersmith Subject: Re: xset support for XKB indicator names [LSARC/2009/361 FastTrack timeout 06/23/2009] In-reply-to: <200906162132.n5GLWj4V003862@sac.sfbay.sun.com> Sender: Alan.Coopersmith@sun.com To: LSARC-ext@sun.com Message-id: <4A44E043.20708@sun.com> MIME-version: 1.0 Content-type: text/plain; CHARSET=US-ASCII Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 X-Enigmail-Version: 0.95.1 References: <200906162132.n5GLWj4V003862@sac.sfbay.sun.com> User-Agent: Thunderbird 2.0.0.21 (X11/20090323) Status: RO Content-Length: 4556 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@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 Committed > xset -led named 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@sun.com Sun Microsystems, Inc. - X Window System Engineering From John.Fischer@sun.com Fri Jun 26 08:22:16 2009 Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n5QFMFsm014885 for ; Fri, 26 Jun 2009 08:22:15 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n5QFMD5V047787 for <@sunmail2sca.sfbay.sun.com:LSARC-ext@sun.com>; Fri, 26 Jun 2009 09:22:15 -0600 (MDT) Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0KLU0040BQP3ZO00@brm-avmta-1.central.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Fri, 26 Jun 2009 09:22:15 -0600 (MDT) Received: from brmea-mail-4.sun.com ([192.18.98.36]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KLU00MX8QP3WX30@brm-avmta-1.central.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Fri, 26 Jun 2009 09:22:15 -0600 (MDT) Received: from fe-amer-10.sun.com ([192.18.109.80]) by brmea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n5QFMFuD015116 for ; Fri, 26 Jun 2009 15:22:15 +0000 (GMT) Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009)) id <0KLU00000OPT4300@mail-amer.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Fri, 26 Jun 2009 09:22:15 -0600 (MDT) Received: from [192.168.10.8] ([unknown] [76.20.56.47]) by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009)) with ESMTPSA id <0KLU000M1QOENT20@mail-amer.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Fri, 26 Jun 2009 09:21:51 -0600 (MDT) Date: Fri, 26 Jun 2009 08:20:15 -0700 From: John Fischer Subject: Re: xset support for XKB indicator names [LSARC/2009/361 FastTrack timeout 06/23/2009] In-reply-to: <4A44E043.20708@sun.com> Sender: John.Fischer@sun.com To: Alan Coopersmith Cc: LSARC-ext@sun.com Reply-to: John.Fischer@sun.com Message-id: <4A44E72F.5090008@sun.com> MIME-version: 1.0 Content-type: text/plain; CHARSET=US-ASCII; format=flowed Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <200906162132.n5GLWj4V003862@sac.sfbay.sun.com> <4A44E043.20708@sun.com> User-Agent: Thunderbird 2.0.0.21 (X11/20090323) Status: RO Content-Length: 4574 +1 Alan Coopersmith wrote: > 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@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 Committed >> xset -led named 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 >> > From Alan.Coopersmith@sun.com Fri Jun 26 16:57:27 2009 Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n5QNvQBG027671 for ; Fri, 26 Jun 2009 16:57:26 -0700 (PDT) Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n5QNvNAh024593 for <@sunmail2sca.sfbay.sun.com:LSARC-ext@sun.com>; Sat, 27 Jun 2009 00:57:25 +0100 (BST) Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0KLV00603EJPGO00@nwk-avmta-1.sfbay.Sun.COM> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Fri, 26 Jun 2009 16:57:25 -0700 (PDT) Received: from sca-es-mail-1.sun.com ([192.18.43.132]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KLV005XVEJOX300@nwk-avmta-1.sfbay.Sun.COM> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Fri, 26 Jun 2009 16:57:24 -0700 (PDT) Received: from fe-sfbay-10.sun.com ([192.18.43.129]) by sca-es-mail-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id n5QNvO5q007354 for ; Fri, 26 Jun 2009 16:57:24 -0700 (PDT) Received: from conversion-daemon.fe-sfbay-10.sun.com by fe-sfbay-10.sun.com (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009)) id <0KLV00I00E7L9900@fe-sfbay-10.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Fri, 26 Jun 2009 16:57:24 -0700 (PDT) Received: from [10.6.102.27] ([unknown] [10.6.102.27]) by fe-sfbay-10.sun.com (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009)) with ESMTPSA id <0KLV008BKEJH8I40@fe-sfbay-10.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Fri, 26 Jun 2009 16:57:18 -0700 (PDT) Date: Fri, 26 Jun 2009 16:57:17 -0700 From: Alan Coopersmith Subject: Re: xset support for XKB indicator names [LSARC/2009/361 FastTrack timeout 06/23/2009] In-reply-to: <4A44E72F.5090008@sun.com> Sender: Alan.Coopersmith@sun.com To: John.Fischer@sun.com Cc: LSARC-ext@sun.com, OpenSolaris X Window System List Message-id: <4A45605D.1020303@sun.com> MIME-version: 1.0 Content-type: text/plain; CHARSET=US-ASCII Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 X-Enigmail-Version: 0.95.1 References: <200906162132.n5GLWj4V003862@sac.sfbay.sun.com> <4A44E043.20708@sun.com> <4A44E72F.5090008@sun.com> User-Agent: Thunderbird 2.0.0.21 (X11/20090323) Status: RO Content-Length: 4934 Thanks. This case is now closed approved. -alan- John Fischer wrote: > +1 > > Alan Coopersmith wrote: >> 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@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 Committed >>> xset -led named 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@sun.com Sun Microsystems, Inc. - X Window System Engineering