emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* [PATCH] Clarify documentation for the %\1, .., %\N template expansion
@ 2016-10-18 23:26 Stig Brautaset
  2016-10-19 17:57 ` Nicolas Goaziou
  0 siblings, 1 reply; 2+ messages in thread
From: Stig Brautaset @ 2016-10-18 23:26 UTC (permalink / raw)
  To: emacs-orgmode


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.
 
 - %? ::          
 
-- 
2.8.4 (Apple Git-73)

^ permalink raw reply related	[flat|nested] 2+ messages in thread

* Re: [PATCH] Clarify documentation for the %\1, .., %\N template expansion
  2016-10-18 23:26 [PATCH] Clarify documentation for the %\1, .., %\N template expansion Stig Brautaset
@ 2016-10-19 17:57 ` Nicolas Goaziou
  0 siblings, 0 replies; 2+ messages in thread
From: Nicolas Goaziou @ 2016-10-19 17:57 UTC (permalink / raw)
  To: emacs-orgmode

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

^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2016-10-19 17:57 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2016-10-18 23:26 [PATCH] Clarify documentation for the %\1, .., %\N template expansion Stig Brautaset
2016-10-19 17:57 ` Nicolas Goaziou

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).