GNU bug report logs - #11440
E-Lisp manual - customization

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 11440 in the body.
You can then email your comments to 11440 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Andrew Kurn <kurn <at> sfu.ca>
To: bug-gnu-emacs <at> gnu.org
Subject: E-Lisp manual - customization
Date: Tue, 8 May 2012 18:54:03 -0700

> 
> (In E-Lisp) I find myself confused by the treatment of Customization and Faces . . .
> 
> I find the chapter in the E-Lisp manual on /Customization/ problematic.  It seems
> to be directed at the user-level and not programmer-level.
> 
> Ideally, it should start out by saying what a customization is actually before
> it ever gets around to defining "Common Keywords" and other ad-hoc machinery.
> So, the first paragraph of the chapter should have a careful definition with
> links to the thingies that a customization is made of or works on.
> 
> I would like a link to "user options" at least, and one to self-quoting
> variables (eg :slant) would help.
> 
> ---
> 
> Please tell me when customization takes place.  Faces seem to be
> synthesized from customization data magically, in some way beyond
> my control.
> 
> 
> ---
> 
> Similarly, the section /Faces/ in /Display/.
> 
> I would start with /Attribute Functions/, so that the machinery that
> does the work is exposed, then /Standard Faces/ and /Face Attributes/
> so that we see what the machinery works on, then /Defining F/, which
> is customization, and attempts to insulate programmers from making
> mistakes.
> 
> Inserting customization too early makes the exposition confusing,
> makes it hard to see what is fundamental.  The mistake I made was modifying
> the customization properties of faces, rather than the faces themselves.
> 
> (In my present mood, I would remove customization from Emacs completely,
> although I can imagine some would be upset.  Still, I wonder what its
> real value is, how many actually need it and use it.)
> 
> ---
> 
> That's my rant for today,
> 
> Andrew
> 
> 

Message #8 received at 11440 <at> debbugs.gnu.org (full text, mbox):

From: Chong Yidong <cyd <at> gnu.org>
To: Andrew Kurn <kurn <at> sfu.ca>
Cc: 11440 <at> debbugs.gnu.org
Subject: Re: bug#11440: E-Lisp manual - customization
Date: Tue, 18 Sep 2012 13:11:57 +0800

Andrew Kurn <kurn <at> sfu.ca> writes:

> I find the chapter in the E-Lisp manual on /Customization/
> problematic.  It seems to be directed at the user-level and not
> programmer-level.
> 
> Ideally, it should start out by saying what a customization is
> 
> I would like a link to "user options" at least, and one to
> self-quoting variables (eg :slant) would help.
> 
> Similarly, the section /Faces/ in /Display/.
> ...
> I would start with /Attribute Functions/

I've updated the manual to address most of these points.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.