[AUCTeX-diffs] GNU AUCTeX branch, master, updated. 0762736d56dfe3877950b81a217899fb7cbaf72b

[Tassilo Horn]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU AUCTeX".

The branch, master has been updated
       via  0762736d56dfe3877950b81a217899fb7cbaf72b (commit)
       via  86a4c75b47f1c57b133b935748523cc5c0f721b5 (commit)
      from  785eabfd6dc8ad1b174bdad449cb2a7d408e1a69 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 0762736d56dfe3877950b81a217899fb7cbaf72b
Author: Tassilo Horn <address@hidden>
Date:   Mon Sep 19 18:11:52 2016 +0200

    Improve docs added/changed in last commit
    
    * doc/auctex.texi (Display): Rewrite WYSIWYG paragraph and add
    references.
    (Fontification of math): Switch order in which multi-level and invisible
    are introduced.  Fix misplaced @xref.

diff --git a/doc/auctex.texi b/doc/auctex.texi
index c8e28f7..9420dfb 100644
--- a/doc/auctex.texi
+++ b/doc/auctex.texi
@@ -1811,19 +1811,24 @@ 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.
 
-Another tool to obtain more WYSIWYG feeling is to set
address@hidden to @code{invisible} so that the
address@hidden 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 and is
-pretty lightweight and reasonable robust, however it only provides a
-limited WYSIWYG feature compared to @previewlatex{} a subsystem of
address@hidden also provides some WYSIWYG features.
+
+First, you can customize @code{font-latex-fontify-script} to enable
+special formatting of @code{^} superscripts and @code{_} subscripts
+(@pxref{Font Locking}).
+
+Secondly, @AUCTeX{} with GNU Emacs 25 or later can display certain math
+macros using Unicode characters, e.g., @code{\alpha} as α.  This is
+called prettification and is lightweight and reasonable robust
+(@pxref{Prettifying}).
+
+A more accurate approach is provided by @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.  Please note that you can use prettification and preview-latex
-together.
+Manual}.  This system uses @LaTeX{} to generate images that are then
+displayed in your buffer.  It is extremely accurate but can be fragile
+with some packages (like older pgf versions).
+
+Please note that you can use prettification and @previewlatex{} together.
 
 @menu
 * Font Locking::                Font Locking
@@ -2183,27 +2188,28 @@ variables @code{font-latex-fontify-script} and
 @code{font-latex-script-display}.
 
 @defopt font-latex-fontify-script
-If non-nil, fontify subscript and superscript strings.
+If non-nil, fontify subscript and superscript strings.  Concretely, this
+means that the scripts are raised or lowered.
+
+Another possiblity is setting this variable to the symbol
address@hidden  In this case, in a formula @code{x^y^z}, y is
+raised above x, and z is raised above y.  With many script levels, the
+text might become too small to be readable.
 
-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
address@hidden  Another possiblity is setting this variable to
-the symbol @code{multi-level}, then y is raised above x, and z is raised
-above y.  With many script levels, the text might become too small to be
-readable.
+Lastly, you can set this variable to @code{invisible} whose behavior is
+like @code{multi-level}, and in addition the super-/subscript characters
address@hidden and @code{_} are not displayed.
 
 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.
-
 @end defopt
 
 @defopt font-latex-script-display
 Display specification for subscript and superscript content.  The car is
 used for subscript, the cdr is used for superscript.  The feature is
 implemented using so-called display properties.  For information on what
-exactly to specify for the values, see @xref{Other Display Specs, , Other
+exactly to specify for the values, see @ref{Other Display Specs, , Other
 Display Specifications, elisp, GNU Emacs Lisp Reference Manual}.
 @end defopt
 

commit 86a4c75b47f1c57b133b935748523cc5c0f721b5
Author: Uwe Brauer <address@hidden>
Date:   Sun Sep 18 17:49:57 2016 +0000

    Add information about prettify and semi WYSIWYG features.
    
    * doc/auctex.texi (Display): Add a sentence about
    prettify-symbols-unprettify-at-point.
    (Fontification of math): add `invisible' to
    `font-latex-fontify-script'.

diff --git a/doc/auctex.texi b/doc/auctex.texi
index 673b6ad..c8e28f7 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
address@hidden to @code{invisible} so that the
address@hidden 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 and is
+pretty lightweight and reasonable robust, however it only provides a
+limited WYSIWYG feature compared to @previewlatex{} a subsystem of
address@hidden, 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.  Please note that you can use prettification and preview-latex
+together.
 
 @menu
 * Font Locking::                Font Locking
@@ -2174,16 +2185,25 @@ variables @code{font-latex-fontify-script} and
 @defopt font-latex-fontify-script
 If non-nil, fontify subscript and superscript strings.
 
-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.
+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
address@hidden  Another possiblity is setting this variable to
+the symbol @code{multi-level}, then y is raised above x, and z is raised
+above y.  With many script levels, the text might become too small to be
+readable.
+
+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.
+
 @end defopt
 
 @defopt font-latex-script-display
 Display specification for subscript and superscript content.  The car is
 used for subscript, the cdr is used for superscript.  The feature is
 implemented using so-called display properties.  For information on what
-exactly to specify for the values, see @ref{Other Display Specs, , Other
+exactly to specify for the values, see @xref{Other Display Specs, , Other
 Display Specifications, elisp, GNU Emacs Lisp Reference Manual}.
 @end defopt
 
@@ -2595,7 +2615,10 @@ 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.  For this
+behaviour however you need to set
address@hidden to t or @code{right-edge}
+which will unprettify the symbol when point moves into or near it.
 
 To enable prettification in @AUCTeX{}, simply add
 @code{prettify-symbols-mode} to @code{TeX-mode-hook}.  If you enabled

-----------------------------------------------------------------------

Summary of changes:
 doc/auctex.texi |   43 ++++++++++++++++++++++++++++++++++++-------
 1 file changed, 36 insertions(+), 7 deletions(-)


hooks/post-receive
-- 
GNU AUCTeX