From mboxrd@z Thu Jan 1 00:00:00 1970 From: Hendrik Tews Subject: [PATCH] document parent property update in column view Date: Tue, 30 May 2017 11:25:52 +0200 Message-ID: <8760gielwf.fsf_-_@cert.kernkonzept.com> References: <87fufxjeeq.fsf@cert.kernkonzept.com> <87lgppf5h7.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:40366) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dFdQc-0000Dh-Cm for emacs-orgmode@gnu.org; Tue, 30 May 2017 05:27:06 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dFdQZ-00054I-5U for emacs-orgmode@gnu.org; Tue, 30 May 2017 05:27:02 -0400 Received: from askra.de ([81.169.225.145]:42188) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dFdQY-00053o-VP for emacs-orgmode@gnu.org; Tue, 30 May 2017 05:26:59 -0400 Received: from ipb218494e.dynamic.kabel-deutschland.de ([178.24.73.78] helo=cert) by askra.de with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1dFdPV-0000PE-9W for emacs-orgmode@gnu.org; Tue, 30 May 2017 11:25:53 +0200 Received: from localhost ([::1] helo=cert.kernkonzept.com) by cert with esmtp (Exim 4.89) (envelope-from ) id 1dFdPU-0006SB-RQ for emacs-orgmode@gnu.org; Tue, 30 May 2017 11:25:52 +0200 In-Reply-To: <87lgppf5h7.fsf@nicolasgoaziou.fr> (Nicolas Goaziou's message of "Mon, 22 May 2017 14:20:20 +0200") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: emacs-orgmode@gnu.org --- 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