Re: update

Silvio Levy <[email protected]> Tue, 08 Mar 2005 07:01:34 -0800
Newsgroups gmane.emacs.auc-tex
Message-ID <[email protected]>
Dear Ralf

Yes, I see your point.  Here is what happened:

> 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.  Or this entry might be
under "Advanced Features" instead of at top level.  Or you might
mention under "Parsing Files" that the stuff about fonts is covered
under "Display -> Font Locking".

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

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.

> I don't think it would be a good idea to add a setq example for each
> variable into the manual.  

I agree.  My (poorly expressed) suggestion was having one
example overall, or one example per group, or per documentation page.

> Somebody accustomed with editing an init
> file should be able to find the doc string or extract the necessary
> information from the manual and know how to construct such a list.

I agree, and I HAD managed to find a sort of solution; but now thanks
to your help I have found the RIGHT solution.

Thanks again for taking the time to respond.

Silvio