From mboxrd@z Thu Jan  1 00:00:00 1970
From: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Subject: Re: question on org-element-interpret-data and when it works
Date: Sat, 03 Mar 2018 15:06:06 +0100
Message-ID: <877eqtgsoh.fsf@nicolasgoaziou.fr>
References: <CAJ51ETrVMD85_HtePY4Z=qjZpV1v4mFg68rnKz5WpqHxO+WP5g@mail.gmail.com>
	<87fu5hbd0k.fsf@gmail.com> <87lgf9gwe7.fsf@nicolasgoaziou.fr>
	<874llxb9cf.fsf@gmail.com> <87bmg5guro.fsf@nicolasgoaziou.fr>
	<87zi3p9t38.fsf@gmail.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]:52517)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1es7ne-0003QV-Lv
	for emacs-orgmode@gnu.org; Sat, 03 Mar 2018 09:06:11 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1es7nd-0001mw-UH
	for emacs-orgmode@gnu.org; Sat, 03 Mar 2018 09:06:10 -0500
Received: from relay2-d.mail.gandi.net ([2001:4b98:c:538::194]:38980)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <mail@nicolasgoaziou.fr>)
	id 1es7nd-0001mi-Nw
	for emacs-orgmode@gnu.org; Sat, 03 Mar 2018 09:06:09 -0500
In-Reply-To: <87zi3p9t38.fsf@gmail.com> (Thorsten Jolitz's message of "Sat, 03
	Mar 2018 14:39:07 +0100")
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: Thorsten Jolitz <tjolitz@gmail.com>
Cc: emacs-orgmode@gnu.org

Thorsten Jolitz <tjolitz@gmail.com> writes:

> You used the word 'discrepancy',

True. I inferred it from

  (funny enough, some org elements have 'value' as their content, others
  'content').

which, IMO, sounds like it is a surprising fact.

> I simply needed to know for each org
> element what is interpreted and what not. And some have a content,
> others a :value.

As in every AST, some nodes are terminal (no contents), and some are not
(contents).

This distinction is made in `org-element-greater-elements', i.e.,
non-terminal elements. See also `org-element-recursive-objects' for
non-terminal objects.

> So if I pass 'Hello World' as content to an example
> block, nothing happens, if I pass it via :value, it appears as the
> blocks ... well, content.

Contents imply Org syntax. This would defeat the purpose of an example
block.