Re: update

* Silvio Levy (2005-03-08) writes:

>> These variables _are_ included in the documentation.  ... If this is
>> not clear enough, please make a suggestion for improving it.
>
> There could be a "Customization" entry at top level (info auctex),
> with just a few links to relevant sections.

Customization options are spread all over the manual because they are
usually explained together with the respective functionality.  So I
don't think this would be very helpful.

> Or this entry might be
> under "Advanced Features" instead of at top level.

Font locking once was explained inside "Advanced Features" but now
that we also have folding to be described the explanations related to
the display of source code grew to large to be kept there.  I thought
it would be better to separate these things from the description of
editing functionality and give them their own chapter.  Maybe the term
"Display" is not descriptive enough?

> Or you might
> mention under "Parsing Files" that the stuff about fonts is covered
> under "Display -> Font Locking".

Hm, I thought it would be obvious that the chapter about parsing
covers something completely different.

> You see, "font locking" is not a term that occurs naturally to people.

"Font locking" is the term usually used for syntax highlighting in the
context of Emacs.

> When I went hunting for variables, the entries that seemed relevant on
> the top-level page were "Advanced Features" and "Parsing Files". I did
> not find again the page where everything is so nicely explained, EVEN
> THOUGH I had looked at it earlier (I know that I did for two reasons:
> I had scanned the documentation a few days earlier, at installation
> time, and I had already tried "customize-group font-latex", which
> failed).  
>
> At the time one really WANTS a piece of information, one sometimes
> can't find it :-( so it helps to have lots of cross-references.

And it helps using the index. (c;  I know that people not familiar with
Emacs use the term syntax highlighting instead of font locking.
That's why it is mentioned right at the start of the "Display" chapter
_and_ got an index entry.  If you are using the info documentation of
AUCTeX, simple type `i syn TAB' and there it is.

-- 
Ralf