From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: storm@cua.dk (Kim F. Storm) Newsgroups: gmane.emacs.devel Subject: Re: keypad-*-setup Date: Tue, 18 Sep 2007 00:04:57 +0200 Message-ID: <87wsupq77a.fsf@kfs-lx.testafd.dk> References: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1190066761 10426 80.91.229.12 (17 Sep 2007 22:06:01 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 17 Sep 2007 22:06:01 +0000 (UTC) Cc: emacs-devel@gnu.org To: "Drew Adams" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Sep 18 00:05:57 2007 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1IXOiU-0003Jf-S4 for ged-emacs-devel@m.gmane.org; Tue, 18 Sep 2007 00:05:46 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IXOiT-0006FK-5C for ged-emacs-devel@m.gmane.org; Mon, 17 Sep 2007 18:05:17 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1IXOiQ-0006ER-FW for emacs-devel@gnu.org; Mon, 17 Sep 2007 18:05:14 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1IXOiP-0006E7-CH for emacs-devel@gnu.org; Mon, 17 Sep 2007 18:05:14 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IXOiP-0006E4-9v for emacs-devel@gnu.org; Mon, 17 Sep 2007 18:05:13 -0400 Original-Received: from mail-relay.sonofon.dk ([212.88.64.25]) by monty-python.gnu.org with smtp (Exim 4.60) (envelope-from ) id 1IXOiO-0005FI-La for emacs-devel@gnu.org; Mon, 17 Sep 2007 18:05:13 -0400 Original-Received: (qmail 56512 invoked from network); 17 Sep 2007 22:04:57 -0000 Original-Received: from unknown (HELO kfs-lx.testafd.dk.cua.dk) (213.83.150.2) by 0 with SMTP; 17 Sep 2007 22:04:57 -0000 In-Reply-To: (Drew Adams's message of "Wed\, 12 Sep 2007 10\:22\:23 -0700") User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.1 (gnu/linux) X-Detected-Kernel: FreeBSD 4.6-4.9 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:79133 Archived-At: "Drew Adams" writes: > I've tried to improve the doc for this feature (library keypad.el) - both > the Emacs manual and the doc strings and Customize tags. Great. Thanks. > 1. A nil ("No change (keep existing bindings)") value for the setup options > seems to be a no-op. What is its use; what does it do (change)? If it does > nothing, then perhaps we should remove it (and modify the doc accordingly). > Here is the :set code for `defcustom' - it seems to do nothing if `value' is > nil. Am I reading this wrong? I don't really remember why I included that choice. Most likely it was a way to specify "use default bindings or whatever the user has changed them to". > > 2. Do we really need a separate `numeric' choice? Why not always specify an > explicit decimal-point? That is, why not get rid of the value `numeric' > ("Numeric with standard decimal point") and just use the version that > specifies a decimal-point character - it uses `.' as the default value, > which is the same as choosing the option value `numeric'. IIRC, the intention was to _somehow_ find the proper decimal point character from the language/regional environment settings. I probably didn't finish it because I don't know how to do that. > 3. Shouldn't `integerp' be `char-valid-p' in the test for the value? :match > (lambda (widget value) (integerp value)). In function `keypad-setup', > `char-valid-p' is used to test the character. That sounds right - but I don't remember. In general I think your descriptions are very good, but OTOH I also think that some of the text is too verbose and elaborates too much on some of the trivial issues. > Other keys that might be physically nearby, such as the keypad PF keys > (e.g. `') and the keys labeled `/', `*', `-', `+', and `Enter', > are not considered part of the keypad, as the term is understood ^numeric > here. > This means that only some of the keys with names starting with `kp-' > are considered "keypad" keys in this section. For example, the nearby > key labeled `/' is often named `', but it is not a numeric > keypad key. Be aware that in some other contexts any key whose Emacs > name starts with `kp-' might be considered a "keypad" key. See, for > instance, (elisp) "Function Keys". This is true, but formally it doesn't add any information that the previous section didn't say implicitly - so it could be removed. > The Shift key and the NumLock key modify the behavior of keys on the > numeric keypad. The Shift key acts as usual. The NumLock key is > usually near the keypad keys. It acts similarly to the Caps Lock key, > but instead of toggling between uppercase and lowercase for the main > keyboard it toggles the keypad keys between two possible modes: > numeric and non-numeric. Like the Caps Lock key, and unlike the Shift > key, NumLock is modal: hitting it once enters a mode that stays active > until you hit it again to change the mode. NumLock is not a modifier > key: you do not hold it down while hitting other keys. I think most users will know that NumLock is modal - and that you don't have to hold it down - so this section could be more terse. E.g. something like this should be sufficient IMO: The Shift key and the NumLock key modify the behavior of keys on the numeric keypad. The Shift key acts as usual. The NumLock key toggles the keypad keys between two possible modes: numeric and non-numeric. -- Kim F. Storm http://www.cua.dk