From mboxrd@z Thu Jan  1 00:00:00 1970
From: Jambunathan K <kjambunathan@gmail.com>
Subject: Re: Outline cycling does not preserve point's position
Date: Wed, 11 Sep 2013 17:04:35 +0530
Message-ID: <87li334mno.fsf@gmail.com>
References: <7CB7B681-DD2E-446C-AE45-DDCA204EE95C@gmail.com>
	<5855E8E1-9730-4A29-89FF-E35C64E54EDD@gmail.com>
	<20130910073257.GO20690@kuru.dyndns-at-home.com>
	<20130910075345.GP20690@kuru.dyndns-at-home.com>
	<25A21DB7-B2E5-47BB-8A64-594A15CB24B8@gmail.com>
	<EDC473E1-8973-4B42-9038-79C66F67B333@gmail.com>
	<20130910085057.GQ20690@kuru.dyndns-at-home.com>
	<4ED2509E-8A2E-4ED2-BFCF-CB7B27F1D2B4@gmail.com>
	<20130910095043.GR20690@kuru.dyndns-at-home.com>
	<87a9jk8wmr.fsf@gmail.com>
	<20130910185843.GA20690@kuru.dyndns-at-home.com>
	<871u4w8nkq.fsf@gmail.com> <8761u8m5sd.fsf@gmail.com>
	<87ioy78vib.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]:44766)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <kjambunathan@gmail.com>) id 1VJies-0003jm-9E
	for emacs-orgmode@gnu.org; Wed, 11 Sep 2013 07:32:35 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <kjambunathan@gmail.com>) id 1VJiem-0004ru-Mx
	for emacs-orgmode@gnu.org; Wed, 11 Sep 2013 07:32:30 -0400
Received: from mail-pb0-x234.google.com ([2607:f8b0:400e:c01::234]:40429)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <kjambunathan@gmail.com>) id 1VJiem-0004r7-Fd
	for emacs-orgmode@gnu.org; Wed, 11 Sep 2013 07:32:24 -0400
Received: by mail-pb0-f52.google.com with SMTP id wz12so8940855pbc.11
	for <emacs-orgmode@gnu.org>; Wed, 11 Sep 2013 04:32:23 -0700 (PDT)
In-Reply-To: <87ioy78vib.fsf@gmail.com> (Nicolas Goaziou's message of "Wed, 11
	Sep 2013 13:09:48 +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-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
To: Nicolas Goaziou <n.goaziou@gmail.com>
Cc: emacs-orgmode@gnu.org, Carsten Dominik <carsten.dominik@gmail.com>


I will try out your changes later in the day...

Meanwhile,

> I don't know what "pre-order" means. What about
> `org-flat-forward-element' 

By, flat or linear you really mean a serialized (or stringified) version
of parse-tree.  i.e., An Org buffer is really a serialized
representation of the parse tree.

> or simply (but misleading) `org-forward-paragraph'?

http://en.wikipedia.org/wiki/Pre-order_traversal

Even pre-order could be misleading.  

`org-forward-paragraph' is much better.  As long as the docstring or
comments mention that Org's notion of paragraph is much more nuanced or
richer than a text-mode's notion of paragraph.  

I insist on this, only because description (even if exhaustive) could be
misleading and restrictive.  But an Imagery (or a mental model) is
usually richer and generative.