From: Gregor Zattler <telegraph@gmx.net>
To: emacs-orgmode <emacs-orgmode@gnu.org>
Subject: Re: keys and command name info
Date: Mon, 9 Aug 2010 00:26:36 +0200 [thread overview]
Message-ID: <20100808222636.GF20223@shi.workgroup> (raw)
In-Reply-To: <B8B48AC4-E990-4BD0-BB64-0E5E10DF1CF8@gmail.com>
Hi Carsten, org-mode developers,
* Carsten Dominik <carsten.dominik@gmail.com> [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.
next prev parent reply other threads:[~2010-08-08 22:27 UTC|newest]
Thread overview: 44+ messages / expand[flat|nested] mbox.gz Atom feed top
2010-07-28 19:36 keys and command name info Andreas Röhler
2010-07-29 6:45 ` Tassilo Horn
2010-07-29 13:47 ` Andreas Röhler
2010-07-29 15:19 ` Andreas Röhler
2010-07-29 18:08 ` Tassilo Horn
2010-07-30 9:40 ` Andreas Röhler
2010-08-07 19:39 ` Carsten Dominik
2010-08-08 13:57 ` Andreas Röhler
2010-07-31 8:53 ` Bastien
2010-07-31 17:53 ` Andreas Röhler
2010-07-31 19:02 ` Thomas S. Dye
2010-08-01 9:42 ` Bastien
2010-08-01 16:40 ` Andreas Röhler
2010-08-02 6:32 ` Carsten Dominik
2010-08-08 22:26 ` Gregor Zattler [this message]
2010-08-09 6:43 ` Carsten Dominik
2010-08-09 9:37 ` Andreas Burtzlaff
2010-08-09 10:19 ` Gregor Zattler
2010-08-09 10:31 ` Carsten Dominik
2010-08-09 18:32 ` Dan Davison
2010-08-09 19:28 ` Dan Davison
2010-08-11 10:05 ` Carsten Dominik
2010-08-11 10:23 ` Andreas Röhler
2010-08-11 10:27 ` Carsten Dominik
2010-08-13 13:45 ` Andreas Röhler
2010-08-13 14:20 ` Dan Davison
2010-08-13 19:30 ` Andreas Röhler
2010-08-15 7:37 ` Carsten Dominik
2010-08-15 7:39 ` Carsten Dominik
2010-08-15 19:07 ` Andreas Röhler
2010-08-16 8:57 ` Carsten Dominik
2010-08-17 12:43 ` Andreas Röhler
2010-08-18 8:38 ` Carsten Dominik
2010-08-20 6:27 ` Andreas Röhler
2010-08-20 7:31 ` Carsten Dominik
2010-08-20 8:13 ` Andreas Röhler
2010-08-20 7:44 ` Carsten Dominik
2010-08-17 15:44 ` Andreas Röhler
2010-08-10 1:28 ` Memnon Anon
2010-08-09 14:23 ` Nick Dokos
2010-08-10 7:48 ` OT: smex.el (was Re: keys and command name info) Austin Frank
2010-08-20 11:20 ` keys and command name info Carsten Dominik
2010-08-20 11:32 ` Stefan Vollmar
2010-08-20 13:23 ` Bernt Hansen
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20100808222636.GF20223@shi.workgroup \
--to=telegraph@gmx.net \
--cc=emacs-orgmode@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).