From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nick Dokos Subject: Re: org-hide-emphasis-markers not mentioned in the org manual Date: Wed, 15 Nov 2017 10:27:45 -0500 Message-ID: <87k1yry32m.fsf@alphaville.usersys.redhat.com> References: <23051.4978.1475.216563@frac.u-strasbg.fr> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:54013) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eEzbh-0003Mf-PS for emacs-orgmode@gnu.org; Wed, 15 Nov 2017 10:28:06 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eEzbc-0008IO-Cp for emacs-orgmode@gnu.org; Wed, 15 Nov 2017 10:28:05 -0500 Received: from [195.159.176.226] (port=56751 helo=blaine.gmane.org) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1eEzbc-0008H5-5W for emacs-orgmode@gnu.org; Wed, 15 Nov 2017 10:28:00 -0500 Received: from list by blaine.gmane.org with local (Exim 4.84_2) (envelope-from ) id 1eEzbO-0000ij-3D for emacs-orgmode@gnu.org; Wed, 15 Nov 2017 16:27:46 +0100 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: emacs-orgmode@gnu.org Alain.Cochard@unistra.fr writes: > Thomas Rikl writes on Tue 14 Nov 2017 14:10: > > > (and perhaps other customization variables) > > > > Version: Release 9.1.2 (release 9.1.2-192-gc029c4) > > of the org manual > > > > regards Thomas R. > > In a recent (late sept.) discussion on this list ("Confused about the > explanation for 'org-cycle"), it was argued by Org experts that > documenting every customization variable was not the best way to go. That's not quite right: it should say " ... documenting every customization variable *in the manual* was not the best way to go." *All* customization variables should be documented. You can get that documentation with C-h v RET If there is no such documentation, that's a bug. You can also use "customize" to list such variables (or groups of related variables). The manual is a good way to start, but it does noe wander into the darker corners. Fortunately, emacs provides enough flash lights to illuminate them. Knowing about these is important: it makes your (emacs) life easier, more productive and more enjoyable. > So maybe this also applies for the particular case of > org-hide-emphasis-markers... > > Regards -- Nick