[elpa] externals/org a240332 2/2: etc/ORG-NEWS: Announce clocktable per-file time percentages (':formula %')

[ELPA Syncer]

branch: externals/org
commit a2403321acf5f03efae1df3078fd46df1c30b5ed
Author: Alan D. Salewski <ads@salewski.email>
Commit: Bastien Guerry <bzg@gnu.org>

    etc/ORG-NEWS: Announce clocktable per-file time percentages (':formula %')
    
    * etc/ORG-NEWS: New entry announcing clocktable calculation and
    display of per-file time percentages, when ':formula %' is used.
    
    TINYCHANGE
    
    Signed-off-by: Alan D. Salewski <ads@salewski.email>
---
 etc/ORG-NEWS | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/etc/ORG-NEWS b/etc/ORG-NEWS
index 0c822d0..d08e3f6 100644
--- a/etc/ORG-NEWS
+++ b/etc/ORG-NEWS
@@ -235,6 +235,23 @@ tags including from both buffer local and user defined 
persistent
 global list (~org-tag-alist~ and ~org-tag-persistent-alist~).  Now
 option ~org-complete-tags-always-offer-all-agenda-tags~ is honored.
 
+*** Clocktable option =:formula %= now shows the per-file time percentages
+
+This change only has an effect when multiple files are contributing to
+a given clocktable (such as when =:scope agenda= has been specified).
+The existing behavior is that such tables have an extra 'File' column,
+and each individual file that contributes has its own summary line
+with the headline value '*File time*'.  Those summary rows also
+produce a rollup time value for the file in the 'Time' column.
+
+Prior to this change, the built-in =%= formula did not produce a
+calculation for those per-file times in the '%' column (the relevant
+cells in the '%' column were blank).  With this change, the
+percentage contribution of each individual file time to the total
+time is shown.
+
+The more agenda files you have, the more useful this behavior becomes.
+
 ** Miscellaneous
 *** Missing or empty placeholders in "eval" macros are now nil
 They used to be the empty string.