[AUCTeX-diffs] Changes to auctex/doc/auctex.texi,v

[Ralf Angeli]

CVSROOT:        /cvsroot/auctex
Module name:    auctex
Changes by:     Ralf Angeli <angeli>    08/06/07 18:12:10

Index: auctex.texi
===================================================================
RCS file: /cvsroot/auctex/auctex/doc/auctex.texi,v
retrieving revision 1.286
retrieving revision 1.287
diff -u -b -r1.286 -r1.287
--- auctex.texi 17 May 2008 16:53:38 -0000      1.286
+++ auctex.texi 7 Jun 2008 18:12:10 -0000       1.287
@@ -1415,11 +1415,20 @@
 accessible with @kbd{M-x customize-group RET font-latex RET}.  For this
 description the various options are explained in conceptional groups.
 
address@hidden Macros
address@hidden
+* Fontification of macros::     Fontification of macros
+* Fontification of quotes::     Fontification of quotes
+* Subscript and superscript::   Subscript and superscript in math
+* Verbatim content::            Verbatim macros and environments
+* Multi-line fontification::    Multi-line fontification
+* Faces::                       Faces used by font-latex
address@hidden menu
+
address@hidden Fontification of macros
address@hidden Fontification of macros
 
 Highlighting of macros can be customized by adapting keyword lists which
-can be found in the customization group @code{font-latex-keywords}.  The
-lists contain names of macros without the leading backslash.
+can be found in the customization group @code{font-latex-keywords}.
 
 Three types of macros can be handled differently with respect to
 fontification:
@@ -1445,6 +1454,32 @@
 groupings.  The respective face will be applied to the macro itself.
 @end enumerate
 
+Customization variables for @address@hidden@}} type macros allow
+both the macro name and the sequence of arguments to be specified.  The
+latter is done with a string which can contain the characters
address@hidden @samp
address@hidden *
+indicating the existence of a starred variant for the macro,
address@hidden [
+for optional arguments in brackets,
address@hidden @{
+for mandatory arguments in braces,
address@hidden \
+for mandatory arguments consisting of a single macro and
address@hidden |
+as a prefix indicating that two alternatives are following.
address@hidden table
+For example the specifier for @samp{\documentclass} would be @address@hidden
+because the macro has one optional followed by one mandatory argument.
+The specifier for @samp{\newcommand} would be @samp{*|@address@hidden because
+there is a starred variant, the mandatory argument following the macro
+name can be a macro or a @TeX{} group which can be followed by two
+optional arguments and the last token is a mandatory argument in braces.
+
+Customization variables for the @address@hidden address@hidden and @samp{\foo}
+types are simple lists of strings where each entry is a macro name
+(without the leading backslash).
+
 @subheading General macro classes
 
 @fontlatex{} provides keyword lists for different macro classes which
@@ -1476,7 +1511,7 @@
 @item font-latex-match-variable-keywords
 Keywords for macros defining or related to variables, like
 @address@hidden
-Type: @address@hidden@address@hidden@address@hidden
+Type: @address@hidden@address@hidden
 Face: @code{font-lock-variable-name-face}
 
 @item font-latex-match-warning-keywords
@@ -1624,8 +1659,10 @@
 classes or other names given by you.  Additionally the names must not
 contain spaces.
 
-The keywords are names of commands you want to match omitting the
-leading backslash.
+The list of keywords defines which commands and declarations should be
+covered by the keyword class.  A keyword can either be a simple command
+name omitting the leading backslash or a list consisting of the command
+name and a string specifying the sequence of arguments for the command.
 
 The face argument can either be an existing face or font specifications
 made by you.  (The latter option is not available on XEmacs.)
@@ -1635,7 +1672,8 @@
 arguments''---which correspond with the macro types explained above.
 @end defopt
 
address@hidden Quotes
address@hidden Fontification of quotes
address@hidden Fontification of quotes
 @cindex Quotes, fontification of
 
 Text in quotation marks is displayed with the face
@@ -1665,7 +1703,8 @@
 fontified.
 @end defopt
 
address@hidden Subscript and superscript in math
address@hidden Subscript and superscript
address@hidden Subscript and superscript in math
 @cindex Subscript, fontification of
 @cindex Superscript, fontification of
 
@@ -1691,7 +1730,8 @@
 Display Specifications, elisp, GNU Emacs Lisp Reference Manual}.
 @end defopt
 
address@hidden Verbatim macros and environments
address@hidden Verbatim content
address@hidden Verbatim macros and environments
 @cindex Verbatim, fontification of
 
 Usually it is not desirable to have content to be typeset verbatim
@@ -1709,7 +1749,8 @@
 @code{LaTeX-verbatim-macros-with-braces}, and
 @code{LaTeX-verbatim-environments} respectively.
 
address@hidden Multi-line fontification
address@hidden Multi-line fontification
address@hidden Multi-line fontification
 
 Font locking in @LaTeX{} source code often involves constructs spanning
 more than one line of text.  For these constructs to be handled
@@ -1729,7 +1770,8 @@
 controlled by @fontlatex{} or restarting Emacs.
 @end defopt
 
address@hidden Faces
address@hidden Faces
address@hidden Faces used by @fontlatex{}
 @cindex Faces
 
 In case you want to change the colors and fonts used by @fontlatex{}