# HG changeset patch # User Uwe Brauer # Date 1473955431 0 # Thu Sep 15 16:03:51 2016 +0000 # Node ID b60638f575a06f0ca4c57cfd80d7f9fd72864e5f # Parent f2ee83e9c9f8c71fb8d574cdedd0486ad4849512 doc/auctex.texi: Modify text for WYSIWYG paragraph, shorten reference to x-symbol. Compare prettification and preview-latex. diff --git a/doc/auctex.texi b/doc/auctex.texi --- a/doc/auctex.texi +++ b/doc/auctex.texi @@ -1811,8 +1811,20 @@ 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 address@hidden to ‘invisible’ so that the «^» and «_» 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. XEmacs +user should either switch to GNU Emacs 25 or use the x-symbol package +which provides a similar feature. Prettification is pretty lightweight +and reasonable robust, however it only provides a limited WYSIWYG feature, +compared to @previewlatex{} a subsystem of @AUCTeX{}, see address@hidden,,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 +2186,10 @@ @defopt font-latex-fontify-script If non-nil, fontify subscript and superscript strings. +In addition you can configure Emacs so that the «^» and «_» in sub and +superscripts are not displayed. To enable that feature you have to set +the variable @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,15 +2603,20 @@ @section Prettifying Emacs 25 is able to prettify symbols in programming language buffers, address@hidden for Programs,,,emacs,GNU Emacs Manual}. The canonical address@hidden for Programs,,,emacs,GNU Emacs Manual}. The canonical example is to display @code{(lambda () ...)} as @code{(λ () ...)} in Lisp buffers. @AUCTeX{} can use this feature in order to display certain math macros -and greek letters using their Unicode representation, too. For example, +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. +× β}. When point is on one of the characters, it'll be unprettified +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 # HG changeset patch # User Uwe Brauer # Date 1474105692 0 # Sat Sep 17 09:48:12 2016 +0000 # Node ID 076c97473ae4ed447c4805a5d1067547da3d9a60 # Parent b60638f575a06f0ca4c57cfd80d7f9fd72864e5f Correct incorrect filling caused by sentence-end-double-space to nil. Change «_» and «^» to @code{^} and @code{_}, Change @font-latex-fontify-script{} --> @code{font-latex-fontify-script}. diff --git a/doc/auctex.texi b/doc/auctex.texi --- a/doc/auctex.texi +++ b/doc/auctex.texi @@ -1812,19 +1812,18 @@ narrow the buffer to the current group and to @LaTeX{} environments. Another tool to obtain more WYSIWYG feeling is to set address@hidden to ‘invisible’ so that the «^» and «_» in -sub and superscripts are not displayed. address@hidden to ‘invisible’ so that the @code{^} and address@hidden 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. XEmacs -user should either switch to GNU Emacs 25 or use the x-symbol package -which provides a similar feature. Prettification is pretty lightweight -and reasonable robust, however it only provides a limited WYSIWYG feature, -compared to @previewlatex{} a subsystem of @AUCTeX{}, see address@hidden,,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. +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 address@hidden 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 @@ -2186,9 +2185,9 @@ @defopt font-latex-fontify-script If non-nil, fontify subscript and superscript strings. -In addition you can configure Emacs so that the «^» and «_» in sub and -superscripts are not displayed. To enable that feature you have to set -the variable @font-latex-fontify-script{} to ‘invisible’. +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 @@ -2608,13 +2607,13 @@ Lisp buffers. @AUCTeX{} can use this feature in order to display certain math macros -and greek letters using their Unicode representation, too. For example, +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. Note that when +× β}. When point is on one of the characters, it'll be unprettified +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 +complete macro which just gets displayed as α. To delete the whole macro, use @code{kill-word} or @code{backward-kill-word}.