[elpa] externals/org 21413d3589 1/2: org-clock-report: Improve docstring

[ELPA Syncer]

branch: externals/org
commit 21413d3589e2ad817c29add963ab0ebd8e3f1186
Author: Ihor Radchenko <yantar92@posteo.net>
Commit: Ihor Radchenko <yantar92@posteo.net>

    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 <oub@mat.ucm.es>
    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 9dacc050d4..604b5481c8 100644
--- a/lisp/org-clock.el
+++ b/lisp/org-clock.el
@@ -2146,10 +2146,12 @@ If point is inside an existing clocktable block, update 
it.
 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."