From mboxrd@z Thu Jan  1 00:00:00 1970
From: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Subject: Re: Results with #+begin_example/#+end_example don't get overwritten
Date: Wed, 29 Nov 2017 00:16:34 +0100
Message-ID: <87tvxeouy5.fsf@nicolasgoaziou.fr>
References: <CAFyQvY3vUbaxUVyNoXg7VaTnumULkKj8TSpZ-f65PG5A_GxAvg@mail.gmail.com>
	<CAFyQvY1OTY-xg4==OSCAqR=UmfdxC=nVi78EPv8fPdKZMtrZ+Q@mail.gmail.com>
	<878teqqbdf.fsf@nicolasgoaziou.fr>
	<CAFyQvY3SD58UggLeHCzot6-U8usHPd8BYW+NtGHTXDGubPaWfg@mail.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]:33344)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1eJp7F-0006XC-RL
	for emacs-orgmode@gnu.org; Tue, 28 Nov 2017 18:16:38 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1eJp7E-0000dt-Uj
	for emacs-orgmode@gnu.org; Tue, 28 Nov 2017 18:16:37 -0500
Received: from relay2-d.mail.gandi.net ([2001:4b98:c:538::194]:40875)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <mail@nicolasgoaziou.fr>)
	id 1eJp7E-0000ck-O6
	for emacs-orgmode@gnu.org; Tue, 28 Nov 2017 18:16:36 -0500
In-Reply-To: <CAFyQvY3SD58UggLeHCzot6-U8usHPd8BYW+NtGHTXDGubPaWfg@mail.gmail.com>
	(Kaushal Modi's message of "Tue, 28 Nov 2017 22:45:22 +0000")
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: Kaushal Modi <kaushal.modi@gmail.com>
Cc: emacs-org list <emacs-orgmode@gnu.org>

Kaushal Modi <kaushal.modi@gmail.com> writes:

> Regarding the earlier point I made about data safety, should we mention in
> the manual that a user must always leave a blank line after #+RESULTS,
> especially if they have one of these following the #+RESULTS: keyword?
>
> (drawer example-block export-block fixed-width item plain-list src-block
> table)

AFAICT, there is no place in the manual that explains what is the
RESULTS keyword and under what circumstances it could be useful to write
it manually.

Therefore, I think detailing the caveats of RESULTS manual insertion is
a bit premature at this point.

WDYT?