From: Carsten Dominik <carsten.dominik@gmail.com>
To: Dave Abrahams <dave@boostpro.com>
Cc: emacs-orgmode@gnu.org
Subject: Re: Bug: Bad doc [7.4]
Date: Mon, 20 Dec 2010 17:59:09 +0100 [thread overview]
Message-ID: <74E10A8E-5BCD-4B2B-A2E0-24CFC019F0C0@gmail.com> (raw)
In-Reply-To: <m239psjsby.wl%dave@boostpro.com>
On Dec 20, 2010, at 5:56 PM, Dave Abrahams wrote:
> At Mon, 20 Dec 2010 15:16:28 +0100,
> Carsten Dominik wrote:
>>
>>> Hmm, seems to me that it would be more principled to have org-
>>> capture
>>> take an optional argument that indicates the template index, and ask
>>> me and John to bind our key to (lambda () (org-capture 0))
>>
>> You are right, this is better for consistency.
>
> Plus, it would fix your documentation :-)
>
> Here's a guideline I use:
>
> if you're finding it difficult to document the behavior accurately,
> you probably designed it wrong or maybe you don't even really
> understand what it does.
>
> That has happened to me enough times that it was worth making up a
> guideline.
>
>> You can do that already, bind something like (org-capture "t")
>> where "t" is the selection key.
>>
>> (define-key global-map "\C-c c"
>> (lambda () (interactive) (org-capture "t")))
>
> Thanks; if the behavior is ever updated I will switch to that
> arrangement.
It alreay has been changed
- Carsten
prev parent reply other threads:[~2010-12-20 16:59 UTC|newest]
Thread overview: 11+ messages / expand[flat|nested] mbox.gz Atom feed top
2010-12-20 6:12 Bug: Bad doc [7.4] Dave Abrahams
2010-12-20 6:22 ` Leo
2010-12-20 7:21 ` Dave Abrahams
2010-12-20 6:28 ` Noorul Islam K M
2010-12-20 6:58 ` Nick Dokos
2010-12-20 8:08 ` Dave Abrahams
2010-12-20 7:40 ` Carsten Dominik
2010-12-20 8:06 ` Dave Abrahams
2010-12-20 14:16 ` Carsten Dominik
2010-12-20 16:56 ` Dave Abrahams
2010-12-20 16:59 ` Carsten Dominik [this message]
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=74E10A8E-5BCD-4B2B-A2E0-24CFC019F0C0@gmail.com \
--to=carsten.dominik@gmail.com \
--cc=dave@boostpro.com \
--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).