From mboxrd@z Thu Jan  1 00:00:00 1970
From: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Subject: Re: Confused about the explanation for 'org-cycle'
Date: Tue, 26 Sep 2017 12:41:39 +0200
Message-ID: <877ewl4u8s.fsf@nicolasgoaziou.fr>
References: <22975.53875.671661.416361@frac.u-strasbg.fr>
	<874lrzl1gr.fsf@fastmail.fm> <87lgl963jf.fsf@nicolasgoaziou.fr>
	<22986.5564.583945.909910@frac.u-strasbg.fr>
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]:53672)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1dwnJ9-0005Lj-3D
	for emacs-orgmode@gnu.org; Tue, 26 Sep 2017 06:41:43 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1dwnJ8-0005pE-5t
	for emacs-orgmode@gnu.org; Tue, 26 Sep 2017 06:41:43 -0400
Received: from relay4-d.mail.gandi.net ([2001:4b98:c:538::196]:45613)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <mail@nicolasgoaziou.fr>)
	id 1dwnJ7-0005ok-VC
	for emacs-orgmode@gnu.org; Tue, 26 Sep 2017 06:41:42 -0400
In-Reply-To: <22986.5564.583945.909910@frac.u-strasbg.fr> (Alain Cochard's
	message of "Tue, 26 Sep 2017 10:54:20 +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: Alain.Cochard@unistra.fr
Cc: emacs-orgmode@gnu.org

Hello,

Alain.Cochard@unistra.fr writes:

> But now, compared to the previous version:
>
>    When the cursor is at the beginning of the buffer and the first
>    line is not a headline, then <TAB> actually runs global cycling
>
> it is not clear to me why the mention "and the first line is not a
> headline" has been suppressed.

I traded completeness for clarity. 

The reasoning is that the description about a pathological case -- here,
the first line of the buffer being a heading -- belongs to variable's
docstring, not to the manual.

We can add a footnote about that case, but even a footnote impedes
clarity.

Of course, if you have a clear wording that includes that pathological
case, I'll happily use it.

Regards,

-- 
Nicolas Goaziou