Hi

This is a real git patch, not one from hg, the commit message is somehow
improved. Still don't understand why this step is necessary.
>From e3df45c5e28d4e859abc8d6ad5a81811d56d7d3d Mon Sep 17 00:00:00 2001
From: Uwe Brauer <o...@mat.ucm.es>
Date: Thu, 15 Sep 2016 16:03:51 +0000
Subject: [PATCH] =?UTF-8?q?Correct=20incorrect=20filling=20caused=20by=20s?=
 =?UTF-8?q?entence-end-double-space=20to=20nil.=20Change=20=C2=AB=5F=C2=BB?=
 =?UTF-8?q?=20and=20=C2=AB^=C2=BB=20to=20=20@code{^}=20and=20@code{=5F},?=
 =?UTF-8?q?=20Change=20=09@font-latex-fontify-script{}=20-->=20@code{font-?=
 =?UTF-8?q?latex-fontify-script}.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 doc/auctex.texi | 28 ++++++++++++++++++++++++----
 1 file changed, 24 insertions(+), 4 deletions(-)

diff --git a/doc/auctex.texi b/doc/auctex.texi
index 673b6ad..855c20b 100644
--- a/doc/auctex.texi
+++ b/doc/auctex.texi
@@ -1811,8 +1811,19 @@ Moreover, you can focus in a specific portion of the code by narrowing
 the buffer to the desired region.  @AUCTeX{} provides also functions to
 narrow the buffer to the current group and to @LaTeX{} environments.
 
-Lastly, @AUCTeX{} with Emacs 25 or later can display certain math macros
-using Unicode characters.  That's called prettification.
+Another tool to obtain more WYSIWYG feeling is to set
+@code{font-latex-fontify-script} to ‘invisible’ so that the @code{^} and
+@code{_} in sub and superscripts are not displayed.
+
+Lastly, @AUCTeX{} with GNU Emacs 25 or later can display certain math
+macros using Unicode characters.  That's called prettification.
+Prettification is pretty lightweight and reasonable robust, however it
+only provides a limited WYSIWYG feature, compared to @previewlatex{} a
+subsystem of @AUCTeX{}, see @ref{Top,,Introduction,preview-latex,The
+@previewlatex{} Manual}, which let LaTeX generate images that are
+displayed in your buffer.  It is extremely accurate but sometimes fragile
+with some packages.  Note please that you can use prettification and
+preview-latex together.
 
 @menu
 * Font Locking::                Font Locking
@@ -2174,6 +2185,10 @@ variables @code{font-latex-fontify-script} and
 @defopt font-latex-fontify-script
 If non-nil, fontify subscript and superscript strings.
 
+In addition you can configure Emacs so that the @code{^} and @code{_} in
+sub and superscripts are not displayed.  To enable that feature you have
+to set the variable @code{font-latex-fontify-script} to ‘invisible’.
+
 Note that this feature is not available on XEmacs, for which it is
 disabled per default.  In GNU Emacs raising and lowering is not enabled
 for versions 21.3 and before due to it working not properly.
@@ -2587,7 +2602,7 @@ will no longer be required for them.
 @section Prettifying
 
 Emacs 25 is able to prettify symbols in programming language buffers,
-@pxref{Misc for Programs,,,emacs,GNU Emacs Manual}.  The canonical
+@pxref{Misc for Programs,,,emacs,GNU Emacs Manual}. The canonical
 example is to display @code{(lambda () ...)} as @code{(λ () ...)} in
 Lisp buffers.
 
@@ -2595,7 +2610,12 @@ Lisp buffers.
 and greek letters using their Unicode representation, too.  For example,
 the @TeX{} code @code{\alpha \times \beta} will be displayed as @code{α
 × β}.  When point is on one of the characters, it'll be unprettified
-automatically, meaning you see the verbatim text again.
+automatically, meaning you see the verbatim text again.  Note that when
+you inserted \alpha which gets displayed as α, hitting delete after it
+will result in \alph, i.e., just one character is deleted, not the
+complete macro which just gets displayed as α.  To delete the whole
+macro, use @code{kill-word} or @code{backward-kill-word}.
+
 
 To enable prettification in @AUCTeX{}, simply add
 @code{prettify-symbols-mode} to @code{TeX-mode-hook}.  If you enabled
-- 
1.9.1

_______________________________________________
auctex-devel mailing list
auctex-devel@gnu.org
https://lists.gnu.org/mailman/listinfo/auctex-devel

Reply via email to