branch: externals/org
commit 67922b8c0319f30c5e0192315a1a677702aba852
Author: Ihor Radchenko <[email protected]>
Commit: Ihor Radchenko <[email protected]>
org-agenda-prefix-format: Clarify where %(expression) is evaluated
* lisp/org-agenda.el (org-agenda-prefix-format): Document that
expression is evaluated in the agenda buffer, not in Org buffer.
Reported-by: lou <[email protected]>
Link: https://orgmode.org/list/[email protected]
---
lisp/org-agenda.el | 5 ++++-
1 file changed, 4 insertions(+), 1 deletion(-)
diff --git a/lisp/org-agenda.el b/lisp/org-agenda.el
index b720d1e657..0e7cfa5d3d 100644
--- a/lisp/org-agenda.el
+++ b/lisp/org-agenda.el
@@ -1761,7 +1761,10 @@ meaning:
%s Scheduling/Deadline information, a short string
%b show breadcrumbs, i.e., the names of the higher levels
%(expression) Eval EXPRESSION and replace the control string
- by the result
+ by the result. EXPRESSION is evaluated with point
+ in agenda buffer, not in the Org buffer. Use
+ `org-agenda-with-point-at-orig-entry' if you need to
+ move point to entry's position in Org buffer.
All specifiers work basically like the standard `%s' of `format', but
may contain two additional characters: a question mark just after the
