From mboxrd@z Thu Jan 1 00:00:00 1970 From: Memnon Anon Subject: Re: keys and command name info Date: Tue, 10 Aug 2010 03:28:39 +0200 Message-ID: <87mxsvz2lz.fsf@mean.albasani.net> References: <4C5086C1.9060000@easy-emacs.de> <20100808222636.GF20223@shi.workgroup> <770A61DC-4063-4A72-95F2-21F4E7DE6E77@gmail.com> <87fwyom8iv.fsf@gmx.net> <20100809101957.GC14007@shi.workgroup> <878w4f4oy4.fsf@stats.ox.ac.uk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Received: from [140.186.70.92] (port=40460 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Oide5-0000xD-F8 for emacs-orgmode@gnu.org; Mon, 09 Aug 2010 21:28:50 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1Oide2-0005Na-LS for emacs-orgmode@gnu.org; Mon, 09 Aug 2010 21:28:49 -0400 Received: from mail-ew0-f41.google.com ([209.85.215.41]:55148) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Oide2-0005NF-GD for emacs-orgmode@gnu.org; Mon, 09 Aug 2010 21:28:46 -0400 Received: by ewy28 with SMTP id 28so4022321ewy.0 for ; Mon, 09 Aug 2010 18:28:45 -0700 (PDT) In-Reply-To: <878w4f4oy4.fsf@stats.ox.ac.uk> (Dan Davison's message of "Mon, 09 Aug 2010 14:32:19 -0400") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Dan Davison Cc: emacs-orgmode Dan Davison writes: > I would like the command names in the manual. > > - Emacs-lisp has a lovely tradition of naming functions *very* > descriptively and not being afraid to use long names in the interests > of accuracy. It's a shame to lose all that by displaying only key > sequences. It's a linguistic world of its own and I like being exposed > to it. > - While one can do C-h k, that's not the same as the way one learns the > function names by skimming the manual I am 'just a user', with next to nothing elisp skills under his belt. However, I am willing to learn and I try to modify simple bits to the best of my abilities. So, I should probably argue against inclusion of the command names... But I do not. I got into Emacs because of orgmode, but I did not stop there. The Info system is just great for discovering lots of possibilities, and I really got accustomed to seeing the elisp commands associated to the keybindings. Somehow, from the start right until this thread started, it feld curious to me that these are not "right there". Sure, I have less need for them in orgmode than in, say w3m or gnus, because the defaults are so great I never considered to change them, but I (as a still fairly recent Emacs user) felt the documentation - as great as it is! - to be somewhat out of the line in this regard. I do not see my behaviour will change over the times to come, and right, `C-h k' is available to everyone, but I still would humbly vote for following the accustomed style, i.e. including the elisp function names. It is, in my case, rather a vote motivated by consistency. Memnon