From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Goaziou Subject: Re: [PATCH] Clarify documentation for the %\1, .., %\N template expansion Date: Wed, 19 Oct 2016 19:57:04 +0200 Message-ID: <87wph4z0gf.fsf@nicolasgoaziou.fr> References: Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:57582) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bwv6w-0006Uu-EE for emacs-orgmode@gnu.org; Wed, 19 Oct 2016 13:57:07 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bwv6v-0005ny-Kq for emacs-orgmode@gnu.org; Wed, 19 Oct 2016 13:57:06 -0400 Received: from relay4-d.mail.gandi.net ([2001:4b98:c:538::196]:51764) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1bwv6v-0005nV-F0 for emacs-orgmode@gnu.org; Wed, 19 Oct 2016 13:57:05 -0400 Received: from saiph (unknown [IPv6:2a03:a0a0:0:4301::b3c]) (Authenticated sender: mail@nicolasgoaziou.fr) by relay4-d.mail.gandi.net (Postfix) with ESMTPSA id D4CF6172097 for ; Wed, 19 Oct 2016 19:57:03 +0200 (CEST) In-Reply-To: (Stig Brautaset's message of "Wed, 19 Oct 2016 01:26:30 +0200") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: emacs-orgmode@gnu.org Hello, Stig Brautaset writes: > Hello! I failed to understand this part of the template expansion, and > I'm hoping you will consider this an improvement. I mistook the %\n for > a newline and glossed over the description. I'm hoping this makes it > clearer that it's a sequence of placeholders. > > I haven't signed the CLA, but I'm hoping this change is small enough for > that not to be necessary. (Although I don't have a problem with signing > the CLA if you prefer that.) > > diff --git a/contrib/orgmanual.org b/contrib/orgmanual.org > index 8b8ae1e..5a7904d 100644 > --- a/contrib/orgmanual.org > +++ b/contrib/orgmanual.org > @@ -7060,10 +7060,10 @@ here: > ~%^{prompt|default|completion2|completion3...}~. The arrow keys access > a prompt-specific history. > > -- %\n :: > +- %\1, %\2, ..., %\N :: > > - Insert the text entered at the nth %^{PROMPT}, where ~n~ is > - a number, starting from 1. > + Insert the text entered at the Nth %^{PROMPT}, where ~N~ is > + a number starting from 1. "orgmanual.org" is not (yet?) the official documentation, and is lagging behind "org.texi". I applied your suggestions to the latter, and to `org-capture-templates' docstring. Thank you. Regards, -- Nicolas Goaziou