From mboxrd@z Thu Jan 1 00:00:00 1970 From: Gregor Zattler Subject: Re: keys and command name info Date: Mon, 9 Aug 2010 00:26:36 +0200 Message-ID: <20100808222636.GF20223@shi.workgroup> References: <4C5086C1.9060000@easy-emacs.de> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit Return-path: Received: from [140.186.70.92] (port=46801 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OiEKf-0000VP-C1 for emacs-orgmode@gnu.org; Sun, 08 Aug 2010 18:27:06 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OiEKe-00084T-9V for emacs-orgmode@gnu.org; Sun, 08 Aug 2010 18:27:05 -0400 Received: from mailout-de.gmx.net ([213.165.64.22]:46193 helo=mail.gmx.net) by eggs.gnu.org with smtp (Exim 4.69) (envelope-from ) id 1OiEKd-000849-VI for emacs-orgmode@gnu.org; Sun, 08 Aug 2010 18:27:04 -0400 Content-Disposition: inline In-Reply-To: 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: emacs-orgmode Hi Carsten, org-mode developers, * Carsten Dominik [02. Aug. 2010]: > I am not sure I would like such a change because I think it > makes the manual harder and less fluid to read and considerably longer. It makes the manual longer as in bytes/bandwidth but not as in lines which IMHO corresponds with the amount of time one needs to read the manual. If it's consistent within the manual it's IMHO not confusing or harder to read because it's easy to skip. To me actually this hints look like headings. They would support me in skimming a section of commands in order to find the right one. Those paragraphs with key sequences at the beginning are hard to skim because all the info which stands out is not relevant if one searches for a specific action. Seeing how the command is named in the context of usage information might help lisp novices in getting an idea why some solutions work the way they do. Just my 2¢, Gregor > On Jul 28, 2010, at 9:36 PM, Andreas Röhler wrote: >>what about delivering mnemonic command names alongside >>with its keys in org-info? >> >>For example >> >>8.1. Agenda files >> >>[ ... ] >>`C-c [' >> Add current file to the list of agenda files. The file is added to >> the front of the list. If it was already in the list, it is moved >> to the front. With prefix arg, file is added/moved to the end. >> >>might be provided as >> >>8.1. Agenda files >> >>[ ... ] >>`C-c [', org-agenda-file-to-front >> Add current file to the list of agenda files. The file is added to >> the front of the list. If it was already in the list, it is moved >> to the front. With prefix arg, file is added/moved to the end. >> >> >>IMHO it's useful for emacs-beginners, but for hackers >>too, as remembering function names may precede >>remembering keys - which are to change individually >>anyway.