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

[Ralf Angeli]

CVSROOT:        /cvsroot/auctex
Module name:    auctex
Changes by:     Ralf Angeli <angeli>    09/12/26 15:36:34

Index: auctex.texi
===================================================================
RCS file: /cvsroot/auctex/auctex/doc/auctex.texi,v
retrieving revision 1.299
retrieving revision 1.300
diff -u -b -r1.299 -r1.300
--- auctex.texi 6 Dec 2009 11:59:45 -0000       1.299
+++ auctex.texi 26 Dec 2009 15:36:34 -0000      1.300
@@ -1448,6 +1448,7 @@
 * Fontification of math::       Fontification of math constructs
 * Verbatim content::            Verbatim macros and environments
 * Faces::                       Faces used by font-latex
+* Known problems::              Known fontification problems
 @end menu
 
 @node Fontification of macros
@@ -1798,6 +1799,27 @@
 @fontlatex{} are accessible through a customization group by typing
 @kbd{M-x customize-group RET font-latex-highlighting-faces RET}.
 
address@hidden Known problems
address@hidden Known fontification problems
address@hidden Dollar signs, color bleed with
address@hidden Math, fontification problems with
+
+In certain cases the fontification machinery fails to interpret buffer
+contents correctly.  This can lead to color bleed, i.e. large parts of a
+buffer get fontified with an inappropriate face.  A typical situation
+for this to happen is the use of a dollar sign (@samp{$}) in a verbatim
+macro or environment.  If @fontlatex{} is not aware of the verbatim
+construct, it assumes the dollar sign to be a toggle for mathematics and
+fontifies the following buffer content with the respective face until it
+finds a closing dollar sign or till the end of the buffer.
+
+As a remedy you can make the verbatim construct known to @fontlatex{},
address@hidden content}.  If this is not possible, you can insert a
+commented dollar sign (@samp{%$}) at the next suitable end of line as a
+quick workaround.
address@hidden As a last resort one can set `font-lock-keywords-only', but we 
should
address@hidden probably not advise users to do this.
+
 
 @node Folding
 @section Folding Macros and Environments