From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Stephen J. Turnbull" Newsgroups: gmane.emacs.devel Subject: Re: Key Mapping Proposal Date: Sun, 17 Jan 2010 14:49:19 +0900 Message-ID: <87aawdth5s.fsf@uwakimon.sk.tsukuba.ac.jp> References: <16d22e431001151603i5d2fab77u4f3054bb7e708323@mail.gmail.com> <87y6jyo449.fsf@uwakimon.sk.tsukuba.ac.jp> <16d22e431001161041v2adb2ec9odd6ee6f5b528d78c@mail.gmail.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1263706891 19600 80.91.229.12 (17 Jan 2010 05:41:31 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 17 Jan 2010 05:41:31 +0000 (UTC) Cc: emacs-devel@gnu.org To: Noah Lavine Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Jan 17 06:41:23 2010 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 1NWNt5-0005Bt-IX for ged-emacs-devel@m.gmane.org; Sun, 17 Jan 2010 06:41:23 +0100 Original-Received: from localhost ([127.0.0.1]:44771 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NWNt6-0002pk-1D for ged-emacs-devel@m.gmane.org; Sun, 17 Jan 2010 00:41:24 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1NWNsz-0002pd-Si for emacs-devel@gnu.org; Sun, 17 Jan 2010 00:41:17 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1NWNsu-0002pR-91 for emacs-devel@gnu.org; Sun, 17 Jan 2010 00:41:16 -0500 Original-Received: from [199.232.76.173] (port=39620 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NWNsu-0002pO-1A for emacs-devel@gnu.org; Sun, 17 Jan 2010 00:41:12 -0500 Original-Received: from mtps01.sk.tsukuba.ac.jp ([130.158.97.223]:60155) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1NWNst-0004kZ-Bq for emacs-devel@gnu.org; Sun, 17 Jan 2010 00:41:11 -0500 Original-Received: from uwakimon.sk.tsukuba.ac.jp (uwakimon.sk.tsukuba.ac.jp [130.158.99.156]) by mtps01.sk.tsukuba.ac.jp (Postfix) with ESMTP id 77E151537B3; Sun, 17 Jan 2010 14:41:09 +0900 (JST) Original-Received: by uwakimon.sk.tsukuba.ac.jp (Postfix, from userid 1000) id 208211A35F6; Sun, 17 Jan 2010 14:49:20 +0900 (JST) In-Reply-To: <16d22e431001161041v2adb2ec9odd6ee6f5b528d78c@mail.gmail.com> X-Mailer: VM 8.0.12-devo-585 under 21.5 (beta29) "garbanzo" a03421eb562b XEmacs Lucid (x86_64-unknown-linux) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) 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:120134 Archived-At: Noah Lavine writes: > However, it seems like my question and Teemu Likonen's reply show that > the functionality isn't well enough documented yet. It is well documented I think, but in the Emacs-Lisp manual. It's a matter of judgment (and mine doesn't really matter much on this list :-), but IMHO it doesn't belong in the Emacs User manual. Again I commend to you the study of CUA mode, which has been endlessly controversial (partly for reasons of free software advocacy, of course, but also for technical reasons) exactly because trying to move as few as four bindings forces changes throughout the keymap, and then of course it encourages requests for more CUA compatibility, in mouse gestures as well, etc. IOW, any such change is equivalent in difficulty to writing a simple major mode (and can be substantially more difficult if you want to contribute it to the community, because to get much uptake you need to compromise with others' "essential" keybindings. YMMV; I offer my opinion to give you an idea of what kind of contrary opinion may be out there so you can deal with it in advance, not to discourage you from trying. > I think a good solution would be an info node that explains this > mechanism which would be linked from the Customization->Key Bindings > node, with a list of the generic functions that are commonly the > target of keybindings, Doing C-h b in *scratch* gives a pretty close approximation IMO. Try it and let us know. Note that although the default global keymap is one of the most stable features of the Emacs UI, it does change occasionally. Since Emacs is capable of generating it on the fly, I think it's best to point to the functionality of C-h b rather than put a table in the manual. In addition, I would suggest a link to the node on keymaps in the Emacs Lisp manual (which Emacs doesn't install by default, or maybe that's just MacPorts, grr). I think that what you'll find if you browse the help for help is that most of the information you've mentioned is oly a few keystrokes away. It would be useful to provide a summary of how to get the information that you think is useful in the node in the Emacs User guide (although I still think that the detailed information belongs in the Lisp Reference).