> Uwe Brauer writes: > What about the attached patch? Sounds good to me > From a5dff6d46044db868dd95f6b57c28dffb202c308 Mon Sep 17 00:00:00 2001 > Message-Id: > From: Ihor Radchenko > Date: Tue, 15 Nov 2022 09:35:47 +0800 > Subject: [PATCH] org-clock-report: Improve docstring > * lisp/org-clock.el (org-clock-report): Clarify :scope when called > from inside a heading or before first heading. Separate :scope > description into a separate paragraph. > Reported-by: Uwe Brauer > Link: https://orgmode.org/list/87h6z2c8pf.fsf@mat.ucm.es > --- > lisp/org-clock.el | 10 ++++++---- > 1 file changed, 6 insertions(+), 4 deletions(-) > diff --git a/lisp/org-clock.el b/lisp/org-clock.el > index 9dacc050d..604b5481c 100644 > --- a/lisp/org-clock.el > +++ b/lisp/org-clock.el > @@ -2146,10 +2146,12 @@ (defun org-clock-report (&optional arg) > Otherwise, insert a new one. > The new table inherits its properties from the variable > -`org-clock-clocktable-default-properties'. The scope of the > -clocktable, when not specified in the previous variable, is > -`subtree' when the function is called from within a subtree, and > -`file' elsewhere. > +`org-clock-clocktable-default-properties'. > + > +The scope of the clocktable, when not specified in the previous > +variable, is `subtree' of the current heading when the function is > +called from inside heading, and `file' elsewhere (before the first > +heading). > When called with a prefix argument, move to the first clock table > in the buffer and update it." > -- > 2.35.1 -- Warning: Content may be disturbing to some audiences I strongly condemn Putin's war of aggression against the Ukraine. I support to deliver weapons to Ukraine's military. I support the ban of Russia from SWIFT. I support the EU membership of the Ukraine. https://addons.thunderbird.net/en-US/thunderbird/addon/gmail-conversation-view/