[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] elpa 0762736 13/16: Improve docs added/changed in last commit
From: |
Tassilo Horn |
Subject: |
[elpa] elpa 0762736 13/16: Improve docs added/changed in last commit |
Date: |
Fri, 14 Oct 2016 16:03:33 +0000 (UTC) |
branch: elpa
commit 0762736d56dfe3877950b81a217899fb7cbaf72b
Author: Tassilo Horn <address@hidden>
Commit: Tassilo Horn <address@hidden>
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.
---
doc/auctex.texi | 50 ++++++++++++++++++++++++++++----------------------
1 file changed, 28 insertions(+), 22 deletions(-)
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
- [elpa] elpa 50b63b0 07/16: Improve style/graphicx.el, (continued)
- [elpa] elpa 50b63b0 07/16: Improve style/graphicx.el, Tassilo Horn, 2016/10/14
- [elpa] elpa 0392f01 04/16: ; Fix a typo, Tassilo Horn, 2016/10/14
- [elpa] elpa b90986f 01/16: Fix type of ConTeXt-Mark-version option, Tassilo Horn, 2016/10/14
- [elpa] elpa 9e627fc 02/16: Do not use a function from cl, Tassilo Horn, 2016/10/14
- [elpa] elpa 785eabf 11/16: Don't require \end{env} is on a separate line, Tassilo Horn, 2016/10/14
- [elpa] elpa 84d31ca 10/16: Fix default command after running BibTeX with warnings, Tassilo Horn, 2016/10/14
- [elpa] elpa 0c955d5 15/16: Fix TeX--if-macro-fboundp edebug spec, Tassilo Horn, 2016/10/14
- [elpa] elpa 86a4c75 12/16: Add information about prettify and semi WYSIWYG features., Tassilo Horn, 2016/10/14
- [elpa] elpa 75d672c 09/16: Improve font-locking of verbatim environments, Tassilo Horn, 2016/10/14
- [elpa] elpa 18f1783 06/16: Cherry-pick 9c24759a96f41e288841ec2e815d62d58dc01e7a from elpa branch, Tassilo Horn, 2016/10/14
- [elpa] elpa 0762736 13/16: Improve docs added/changed in last commit,
Tassilo Horn <=
- [elpa] elpa eb2d64b 14/16: Fix to my previous commit, Tassilo Horn, 2016/10/14
- [elpa] elpa 3654a62 08/16: Improve style/bidi and add make file entry., Tassilo Horn, 2016/10/14
- [elpa] elpa 5489ef2 16/16: Merge branch 'master' into elpa, Tassilo Horn, 2016/10/14