Re: [PATCH] Clarify documentation for the %\1, .., %\N template expansion

[Nicolas Goaziou <mail@nicolasgoaziou.fr>]

Hello,

Stig Brautaset <stig@brautaset.org> 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