From mboxrd@z Thu Jan 1 00:00:00 1970 From: Carsten Dominik Subject: Re: Bug: Bad doc [7.4] Date: Mon, 20 Dec 2010 17:59:09 +0100 Message-ID: <74E10A8E-5BCD-4B2B-A2E0-24CFC019F0C0@gmail.com> References: <03A952A4-467F-45B8-A668-8991218D6E2A@gmail.com> Mime-Version: 1.0 (Apple Message framework v936) Content-Type: text/plain; charset=US-ASCII; format=flowed; delsp=yes Content-Transfer-Encoding: 7bit Return-path: Received: from [140.186.70.92] (port=54064 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PUj4u-0001Og-8J for emacs-orgmode@gnu.org; Mon, 20 Dec 2010 11:59:18 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PUj4s-0007Di-GL for emacs-orgmode@gnu.org; Mon, 20 Dec 2010 11:59:15 -0500 Received: from mail-bw0-f43.google.com ([209.85.214.43]:36331) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PUj4s-0007DD-BO for emacs-orgmode@gnu.org; Mon, 20 Dec 2010 11:59:14 -0500 Received: by bwz14 with SMTP id 14so3390937bwz.30 for ; Mon, 20 Dec 2010 08:59:13 -0800 (PST) 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: Dave Abrahams Cc: emacs-orgmode@gnu.org 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