all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* Suggestion: rename Org Font Lock customization group
@ 2010-03-28 16:14 Dan Davison
  2010-03-28 16:56 ` Xiao-Yong Jin
  2010-03-28 21:53 ` Carsten Dominik
  0 siblings, 2 replies; 6+ messages in thread
From: Dan Davison @ 2010-03-28 16:14 UTC (permalink / raw)
  To: emacs org-mode mailing list

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:

   [+]-- 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


Dan

p.s. I've renamed Worg/org-faces.org to
Worg/org-tutorials/org-appearance.org and added info related to the
"Font Lock" group as a whole (title etc, org-hide-leading-stars,
org-odd-levels-only), but lots more could be added to this.

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: Suggestion: rename Org Font Lock customization group
  2010-03-28 16:14 Suggestion: rename Org Font Lock customization group Dan Davison
@ 2010-03-28 16:56 ` Xiao-Yong Jin
  2010-03-28 18:04   ` Dan Davison
  2010-03-28 21:53 ` Carsten Dominik
  1 sibling, 1 reply; 6+ messages in thread
From: Xiao-Yong Jin @ 2010-03-28 16:56 UTC (permalink / raw)
  To: Dan Davison; +Cc: emacs org-mode mailing list

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:

I wouldn't invent some new terminology apart from emacs'
own.  But I agree that "font lock" is not friendly to new
users.  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!
-- 
J    c/*    __o/*
X    <\     * (__
Y    */\      <

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: Suggestion: rename Org Font Lock customization group
  2010-03-28 16:56 ` Xiao-Yong Jin
@ 2010-03-28 18:04   ` Dan Davison
  2010-03-28 18:11     ` Dan Davison
  2010-03-28 19:34     ` Xiao-Yong Jin
  0 siblings, 2 replies; 6+ messages in thread
From: Dan Davison @ 2010-03-28 18:04 UTC (permalink / raw)
  To: emacs org-mode mailing list

Xiao-Yong Jin <xj2106@columbia.edu> 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!

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: Suggestion: rename Org Font Lock customization group
  2010-03-28 18:04   ` Dan Davison
@ 2010-03-28 18:11     ` Dan Davison
  2010-03-28 19:34     ` Xiao-Yong Jin
  1 sibling, 0 replies; 6+ messages in thread
From: Dan Davison @ 2010-03-28 18:11 UTC (permalink / raw)
  To: emacs org-mode mailing list

> 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,

Sorry, what I should have said is that it *is* also in the Structure
group :) but I believe that the point still stands, as it is much more
to do with appearance than font lock per se.

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: Suggestion: rename Org Font Lock customization group
  2010-03-28 18:04   ` Dan Davison
  2010-03-28 18:11     ` Dan Davison
@ 2010-03-28 19:34     ` Xiao-Yong Jin
  1 sibling, 0 replies; 6+ messages in thread
From: Xiao-Yong Jin @ 2010-03-28 19:34 UTC (permalink / raw)
  To: Dan Davison; +Cc: emacs org-mode mailing list

On Sun, 28 Mar 2010 14:04:16 -0400, Dan Davison wrote:

> 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...)

Hi Dan,

I previously thought it might confuse new users if we use
different term specifically for org-mode.  But now I
completely agree with you.  "Appearance" is indeed a much
better word for this customize group.
-- 
J    c/*    __o/*
X    <\     * (__
Y    */\      <

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: Suggestion: rename Org Font Lock customization group
  2010-03-28 16:14 Suggestion: rename Org Font Lock customization group Dan Davison
  2010-03-28 16:56 ` Xiao-Yong Jin
@ 2010-03-28 21:53 ` Carsten Dominik
  1 sibling, 0 replies; 6+ messages in thread
From: Carsten Dominik @ 2010-03-28 21:53 UTC (permalink / raw)
  To: Dan Davison; +Cc: emacs org-mode mailing list

Hi Dan,

I have no objection here, please go ahead.

- Carsten

On Mar 28, 2010, at 6:14 PM, 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:
>
>   [+]-- 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
>
>
> Dan
>
> p.s. I've renamed Worg/org-faces.org to
> Worg/org-tutorials/org-appearance.org and added info related to the
> "Font Lock" group as a whole (title etc, org-hide-leading-stars,
> org-odd-levels-only), but lots more could be added to this.
>
>
> _______________________________________________
> Emacs-orgmode mailing list
> Please use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode

- Carsten

^ permalink raw reply	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2010-03-28 21:53 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2010-03-28 16:14 Suggestion: rename Org Font Lock customization group Dan Davison
2010-03-28 16:56 ` Xiao-Yong Jin
2010-03-28 18:04   ` Dan Davison
2010-03-28 18:11     ` Dan Davison
2010-03-28 19:34     ` Xiao-Yong Jin
2010-03-28 21:53 ` Carsten Dominik

Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.