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