Re: [O] [PATCH] org-capture.el: Document what the time stamp is in capture templates

2017-08-05 Thread Nicolas Goaziou
Hello,

Michaël Cadilhac  writes:

> Subject: [PATCH] org-capture.el: Document what the time stamp is in capture
>  templates
>
> * lisp/org-capture.el (org-capture-templates): Make explicit that the time
> stamp aware %-escapes are influenced by `org-capture-use-agenda-date'.

Applied. Thank you.

Regards,

-- 
Nicolas Goaziou



[O] [PATCH] org-capture.el: Document what the time stamp is in capture templates

2017-08-05 Thread Michaël Cadilhac
On 5 August 2017 at 12:46, Adam Porter  wrote:

> If you could send a TINYCHANGE patch to the docstring, I'm sure Nicolas
> would be grateful!  :)

Sure thing!

M.
From 7c8569f6bf694bb45ac5334c3bcb13e54e0d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C3=ABl=20Cadilhac?= 
Date: Sat, 5 Aug 2017 14:53:29 +0200
Subject: [PATCH] org-capture.el: Document what the time stamp is in capture
 templates

* lisp/org-capture.el (org-capture-templates): Make explicit that the time
stamp aware %-escapes are influenced by `org-capture-use-agenda-date'.

TINYCHANGE
---
 lisp/org-capture.el | 9 ++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/lisp/org-capture.el b/lisp/org-capture.el
index 5675de375..627522a26 100644
--- a/lisp/org-capture.el
+++ b/lisp/org-capture.el
@@ -273,8 +273,10 @@ be replaced with content and expanded:
   happens after expanding non-interactive %-escapes, those can
   be used to fill the expression.
   %<...>  The result of format-time-string on the ... format specification.
-  %t  Time stamp, date only.
-  %T  Time stamp with date and time.
+  %t  Time stamp, date only.  The time stamp is the current time,
+  except when called from agendas with `\\[org-agenda-capture]' or
+  with `org-capture-use-agenda-date' set.
+  %T  Time stamp as above, with date and time.
   %u, %U  Like the above, but inactive time stamps.
   %i  Initial content, copied from the active region.  If %i is
   indented, the entire inserted text will be indented as well.
@@ -292,7 +294,8 @@ be replaced with content and expanded:
   %^g Prompt for tags, with completion on tags in target file.
   %^G Prompt for tags, with completion on all tags in all agenda files.
   %^t Like %t, but prompt for date.  Similarly %^T, %^u, %^U.
-  You may define a prompt like: %^{Please specify birthday}t
+  You may define a prompt like: %^{Please specify birthday}t.
+  The default date is that of %t, see above.
   %^C Interactive selection of which kill or clip to use.
   %^L Like %^C, but insert as link.
   %^{prop}p   Prompt the user for a value for property `prop'.
-- 
2.13.3