From: Hendrik Tews <hendrik@askra.de>
To: emacs-orgmode@gnu.org
Subject: [PATCH] document parent property update in column view
Date: Tue, 30 May 2017 11:25:52 +0200 [thread overview]
Message-ID: <8760gielwf.fsf_-_@cert.kernkonzept.com> (raw)
In-Reply-To: <87lgppf5h7.fsf@nicolasgoaziou.fr> (Nicolas Goaziou's message of "Mon, 22 May 2017 14:20:20 +0200")
---
doc/org.texi | 12 +++++++++++-
1 file changed, 11 insertions(+), 1 deletion(-)
diff --git a/doc/org.texi b/doc/org.texi
index 142fa9627..11c6a0f39 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -5263,7 +5263,8 @@ keeping track of your music CDs, where properties could be things such as the
album, artist, date of release, number of tracks, and so on.
Properties can be conveniently edited and viewed in column view
-(@pxref{Column view}).
+(@pxref{Column view}). For certain applications Org mode can compute and
+update certain properties, @pxref{Column attributes}.
@menu
* Property syntax:: How properties are spelled out
@@ -5641,6 +5642,15 @@ optional. The individual parts have the following meaning:
@{est+@} @r{Add @samp{low-high} estimates.}
@end example
+When the column definition contains a summary type, Org mode computes the
+value for parent nodes (i.e., those nodes that contain children nodes). If
+the property is present in the parent node, its value is ignored during the
+computation, but Org mode will update the parent property with the computed
+value afterwards. The computation happens when column view is started and
+when values are updated using the column view interface, @pxref{Using column
+view}. A missing value in a leaf node is treated as zero and can cause
+unexpected results, for instance for the @code{mean} summary type.
+
The @code{est+} summary type requires further explanation. It is used for
combining estimates, expressed as @samp{low-high} ranges or plain numbers.
For example, instead of estimating a particular task will take 5 days, you
--
2.11.0
next prev parent reply other threads:[~2017-05-30 9:27 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2017-05-22 11:53 Bug: turning on column view modifies file [9.0.7 (release_9.0.7-439-g2906e5 @ /home/tews/src/org-mode/lisp/)] Hendrik Tews
2017-05-22 12:20 ` Nicolas Goaziou
2017-05-30 9:25 ` Hendrik Tews [this message]
2017-05-30 11:45 ` [PATCH] document parent property update in column view Nicolas Goaziou
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=8760gielwf.fsf_-_@cert.kernkonzept.com \
--to=hendrik@askra.de \
--cc=emacs-orgmode@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).