From mboxrd@z Thu Jan 1 00:00:00 1970 From: Dan Davison Subject: Re: Suggestion: rename Org Font Lock customization group Date: Sun, 28 Mar 2010 14:04:16 -0400 Message-ID: <871vf4pbkv.fsf@stats.ox.ac.uk> References: <87d3yopgna.fsf@stats.ox.ac.uk> <87mxxsfkpx.fsf@columbia.edu> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1NvwqX-0000cH-Np for emacs-orgmode@gnu.org; Sun, 28 Mar 2010 14:04:26 -0400 Received: from [140.186.70.92] (port=58596 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NvwqV-0000Yo-51 for emacs-orgmode@gnu.org; Sun, 28 Mar 2010 14:04:24 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1NvwqT-00045g-4s for emacs-orgmode@gnu.org; Sun, 28 Mar 2010 14:04:22 -0400 Received: from markov.stats.ox.ac.uk ([163.1.210.1]:63594) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1NvwqS-00045Z-Nn for emacs-orgmode@gnu.org; Sun, 28 Mar 2010 14:04:21 -0400 Received: from blackcap.stats.ox.ac.uk (blackcap.stats [163.1.210.5]) by markov.stats.ox.ac.uk (8.13.6/8.13.6) with ESMTP id o2SI4JhN018177 for ; Sun, 28 Mar 2010 19:04:19 +0100 (BST) In-Reply-To: <87mxxsfkpx.fsf@columbia.edu> (Xiao-Yong Jin's message of "Sun, 28 Mar 2010 12:56:58 -0400") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs org-mode mailing list Xiao-Yong Jin writes: > On Sun, 28 Mar 2010 12:14:49 -0400, Dan Davison wrote: > >> For the sake of non-emacs experts, I think the customization group >> "Org Font Lock" would be better named "Org Appearance". Here's what part of >> the org-customize buffer currently looks like: > Hi Xiao-Yong, I understand that we may not want to change something that's been this way in org-mode for ages, but I don't think I understood your arguments: > I wouldn't invent some new terminology apart from emacs' > own. "Appearance" is not new terminology, it is a very widely-understood word. I'm not suggesting that org refer to font lock using a different term; what I'm suggesting is that that customization group is for changing Org's *appearance*; in fact, that will often concern internal emacs implementation machinery known as font-lock, but who needs to know that?[1] Also, in the Font Lock customization group, users confront the Emacs term "Faces", which is a much more important term for a new user to understand than "Font Lock". > But I agree that "font lock" is not friendly to new > users. Right, when being friendly to new users is the purpose of customize. A further argument that "Font Lock" is a misnomer is that "Org Odd Levels Only" is not related to font lock. It could be put in Structure, but I think the decision to put it in the same group as all the other variables related to appearance made sense. And I think there may be other examples of things that are more helpfully described as "Appearance" than "Font Lock". For example, some of the options in the "Org Startup" group might benefit from also having an entry in an appearance group, e.g. org-hide-block-startup. Or perhaps we could have an option to control whether links to images are replaced in the buffer by the image? (a topic for a different thread...) Dan Footnotes: [1] I know emacs talks about "buffers", which is only really likely to make sense initially to the sort of people who know what malloc is, but I contend that while "buffer" is a towering peak in the linguistic landscape of emacs, "font-lock" is an obscure and ignorable hillock. > We could mention this in info and tutorial so users > new to emacs can know what they should look for. > >> [+]-- Group Org TODO >> [+]-- Group Org Time >> [+]-- Group Org Tags >> [+]-- Group Org Properties >> [+]-- Group Org Agenda >> [+]-- Group Org LaTeX >> [-]-\ Group Org Font Lock >>> [+]-- Group Org Faces >>> |--- Option Org Odd Levels Only >>> |--- Option Org Level Color Stars Only >>> |--- Option Org Hide Leading Stars >>> |--- Option Org Hidden Keywords >>> |--- Option Org Fontify Done Headline >>> |--- Option Org Fontify Emphasized Text >>> |--- Option Org Fontify Whole Heading Line >>> |--- Option Org Highlight Latex Fragments And Specials >>> |--- Option Org Hide Emphasis Markers >>> |--- Option Org Emphasis Regexp Components >>> `--- Option Org Emphasis Alist >> [+]-- Group Org Completion > > It looks really nice. Thanks!