From mboxrd@z Thu Jan  1 00:00:00 1970
From: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Subject: Re: [PATCH] document parent property update in column view
Date: Tue, 30 May 2017 13:45:11 +0200
Message-ID: <87h902601k.fsf@nicolasgoaziou.fr>
References: <87fufxjeeq.fsf@cert.kernkonzept.com>
	<87lgppf5h7.fsf@nicolasgoaziou.fr>
	<8760gielwf.fsf_-_@cert.kernkonzept.com>
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:44000)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1dFfaQ-0005zq-4O
	for emacs-orgmode@gnu.org; Tue, 30 May 2017 07:45:18 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1dFfaM-0002u3-Sf
	for emacs-orgmode@gnu.org; Tue, 30 May 2017 07:45:18 -0400
Received: from relay4-d.mail.gandi.net ([217.70.183.196]:53397)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <mail@nicolasgoaziou.fr>)
	id 1dFfaM-0002tm-MY
	for emacs-orgmode@gnu.org; Tue, 30 May 2017 07:45:14 -0400
In-Reply-To: <8760gielwf.fsf_-_@cert.kernkonzept.com> (Hendrik Tews's message
	of "Tue, 30 May 2017 11:25:52 +0200")
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode/>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Sender: "Emacs-orgmode"
	<emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
To: Hendrik Tews <hendrik@askra.de>
Cc: emacs-orgmode@gnu.org

Hello,

Hendrik Tews <hendrik@askra.de> writes:

> ---
>  doc/org.texi | 12 +++++++++++-
>  1 file changed, 11 insertions(+), 1 deletion(-)

Thank you. Could you provide an appropriate commit message and use "git
format-patch" to send your patch? See
http://orgmode.org/worg/org-contribute.html for details.

Also, note that Texinfo expects sentences to end with two spaces.

> -(@pxref{Column view}).
> +(@pxref{Column view}). For certain applications Org mode can compute and
> +update certain properties, @pxref{Column attributes}.

certain properties (@pxref{Column attributes}).


> +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

---i.e., those nodes that contain children nodes.

> +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 interface (@pxref{Using column view})

> +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 last sentence is only true when the summary function expects
numbers.

Regards,

-- 
Nicolas Goaziou