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: Thu, 28 Sep 2017 23:30:00 +0200
Message-ID: <87k20imrzb.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>
	<877ewl4u8s.fsf@nicolasgoaziou.fr>
	<22986.19586.309718.302611@frac.u-strasbg.fr>
	<87h8vmopww.fsf@nicolasgoaziou.fr>
	<22989.25593.198323.807112@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]:42346)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1dxgNk-0000Au-6x
	for emacs-orgmode@gnu.org; Thu, 28 Sep 2017 17:30:09 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1dxgNf-0007Al-CF
	for emacs-orgmode@gnu.org; Thu, 28 Sep 2017 17:30:08 -0400
Received: from relay3-d.mail.gandi.net ([217.70.183.195]:57297)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <mail@nicolasgoaziou.fr>)
	id 1dxgNf-00076x-5h
	for emacs-orgmode@gnu.org; Thu, 28 Sep 2017 17:30:03 -0400
In-Reply-To: <22989.25593.198323.807112@frac.u-strasbg.fr> (Alain Cochard's
	message of "Thu, 28 Sep 2017 23:04:57 +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

Alain.Cochard@unistra.fr writes:

> I have a fresh example in mind to illustrate my point: this afternoon,
> I was looking for org-blank-before-new-entry.  I vaguely remembered it
> existed and was searching the manual (from Info) with the regexps
> 'blank' and 'list'.  Had the variable been mentioned, I would have
> found it within seconds; by contrast I can't imagine how much time I
> would need using customize-group...

A few seconds... type "org blank" in the search bar, click "Search" and
it is there.

Also, 

  M-x apropos-variable RET org blank list RET

If you use Helm, 

  F1 v org blank

is fast too.

> And, in this case, I don't see
> how having a separate section (e.g., an appendix, much like the
> Variable section), with all variables documented, would remove the
> least bit of clarity.

There are already many ways in Emacs to find a variable. I'm not
convinced that adding such an appendix would be worth the trouble
creating and maintaining it. 

As another data point, Emacs' manual doesn't contain an exhaustive
variable section either.

Regards,