From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Goaziou 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: Received: from eggs.gnu.org ([2001:4830:134:3::10]:53672) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) 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 ) 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 ) 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." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" 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 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