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.
[EMAIL PROTECTED] Macros
[EMAIL PROTECTED]
+* 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
[EMAIL PROTECTED] menu
+
[EMAIL PROTECTED] Fontification of macros
[EMAIL PROTECTED] 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 @[EMAIL PROTECTED]@}} 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
[EMAIL PROTECTED] @samp
[EMAIL PROTECTED] *
+indicating the existence of a starred variant for the macro,
[EMAIL PROTECTED] [
+for optional arguments in brackets,
[EMAIL PROTECTED] @{
+for mandatory arguments in braces,
[EMAIL PROTECTED] \
+for mandatory arguments consisting of a single macro and
[EMAIL PROTECTED] |
+as a prefix indicating that two alternatives are following.
[EMAIL PROTECTED] table
+For example the specifier for @samp{\documentclass} would be @[EMAIL PROTECTED]
+because the macro has one optional followed by one mandatory argument.
+The specifier for @samp{\newcommand} would be @samp{*|@[EMAIL PROTECTED]
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 @[EMAIL PROTECTED] [EMAIL PROTECTED] 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
@[EMAIL PROTECTED]
-Type: @[EMAIL PROTECTED]@[EMAIL PROTECTED]@[EMAIL PROTECTED]
+Type: @[EMAIL PROTECTED]@[EMAIL PROTECTED]
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
[EMAIL PROTECTED] Quotes
[EMAIL PROTECTED] Fontification of quotes
[EMAIL PROTECTED] Fontification of quotes
@cindex Quotes, fontification of
Text in quotation marks is displayed with the face
@@ -1665,7 +1703,8 @@
fontified.
@end defopt
[EMAIL PROTECTED] Subscript and superscript in math
[EMAIL PROTECTED] Subscript and superscript
[EMAIL PROTECTED] 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
[EMAIL PROTECTED] Verbatim macros and environments
[EMAIL PROTECTED] Verbatim content
[EMAIL PROTECTED] 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.
[EMAIL PROTECTED] Multi-line fontification
[EMAIL PROTECTED] Multi-line fontification
[EMAIL PROTECTED] 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
[EMAIL PROTECTED] Faces
[EMAIL PROTECTED] Faces
[EMAIL PROTECTED] Faces used by @fontlatex{}
@cindex Faces
In case you want to change the colors and fonts used by @fontlatex{}
_______________________________________________
auctex-diffs mailing list
[EMAIL PROTECTED]
http://lists.gnu.org/mailman/listinfo/auctex-diffs
