From mboxrd@z Thu Jan  1 00:00:00 1970
From: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Subject: Re: "COMMENT" keyword not properly documented in the manual
Date: Sat, 14 Jan 2017 00:28:02 +0100
Message-ID: <87ziiuzgjh.fsf@nicolasgoaziou.fr>
References: <22638.29899.634767.904773@frac.u-strasbg.fr>
	<87d1fxyusv.fsf@nicolasgoaziou.fr>
	<22644.36612.316302.470247@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]:48786)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1cSBGR-0002fZ-Gp
	for emacs-orgmode@gnu.org; Fri, 13 Jan 2017 18:28:08 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1cSBGQ-0003AL-Lo
	for emacs-orgmode@gnu.org; Fri, 13 Jan 2017 18:28:07 -0500
Received: from relay4-d.mail.gandi.net ([2001:4b98:c:538::196]:53232)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <mail@nicolasgoaziou.fr>)
	id 1cSBGQ-00039g-GF
	for emacs-orgmode@gnu.org; Fri, 13 Jan 2017 18:28:06 -0500
In-Reply-To: <22644.36612.316302.470247@frac.u-strasbg.fr> (Alain Cochard's
	message of "Tue, 10 Jan 2017 08:36:36 +0100")
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 unless the use of this variable is obsolete, I feel it has to be
> documented -- could be as discreet as one sentence in a footnote.
> Otherwise, with a nil default, even people using the export features
> would have difficulties to know about it.

I dropped a note about in "agenda views" part of the manual.
>
> (More generally, what would be the harm of having some appendix with a
> list of all customizable variables?  Seems to me it could help
> beginners to learn Org; sure, there is 'C-h v org-<TAB>', but it's not
> exactly the same for me.)

There is a lot of variables. We cannot possibly document all of them in
the manual. However, the best way for a beginnier to discover these
options is probably to call "M-x customize-group RET org RET".

Regards,

-- 
Nicolas Goaziou                                                0x80A93738