[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[AUCTeX-diffs] [elpa] externals/auctex f0cb472: Release GNU AUCTeX 11.90
|
From: |
Tassilo Horn |
|
Subject: |
[AUCTeX-diffs] [elpa] externals/auctex f0cb472: Release GNU AUCTeX 11.90.0 |
|
Date: |
Wed, 11 Jan 2017 18:05:53 +0000 (UTC) |
branch: externals/auctex
commit f0cb472bba6c8d28cd40b1953f045ba4ffb77fa8
Author: Tassilo Horn <address@hidden>
Commit: Tassilo Horn <address@hidden>
Release GNU AUCTeX 11.90.0
* Version 11.90.0 released.
---
auctex.el | 4 +-
auctex.info | 427 +++++++++++++++++++++++++++++++++-------------------
latex/preview.sty | 2 +-
preview-latex.info | 4 +-
tex-site.el | 4 +-
5 files changed, 279 insertions(+), 162 deletions(-)
diff --git a/auctex.el b/auctex.el
index bc319fd..d68c0e6 100644
--- a/auctex.el
+++ b/auctex.el
@@ -1,8 +1,8 @@
;;; auctex.el --- Integrated environment for *TeX*
-;; Copyright (C) 2014-2016 Free Software Foundation, Inc.
+;; Copyright (C) 2014-2017 Free Software Foundation, Inc.
-;; Version: 11.89.8
+;; Version: 11.90.0
;; URL: http://www.gnu.org/software/auctex/
;; Maintainer: address@hidden
;; Notifications-To: address@hidden
diff --git a/auctex.info b/auctex.info
index 8273f18..3fd3456 100644
--- a/auctex.info
+++ b/auctex.info
@@ -1,6 +1,6 @@
This is auctex.info, produced by makeinfo version 6.3 from auctex.texi.
-This manual is for AUCTeX (version 11.89.8 from 2016-12-22), a
+This manual is for AUCTeX (version 11.90.0 from 2017-01-11), a
sophisticated TeX environment for Emacs.
Copyright (C) 1992-1995, 2001, 2002, 2004-2016 Free Software
@@ -311,11 +311,16 @@ File: auctex.info, Node: Installation, Next: Quick
Start, Prev: Summary, Up:
1.2 Installing AUCTeX
=====================
-The simplest way of installing AUCTeX is by using the Emacs package
-manager integrated in Emacs 24 and greater (ELPA). Simply do 'M-x
-package-list-packages RET', mark the auctex package for installation
-with 'i', and hit 'x' to execute the installation procedure. That's
-all.
+The modern and strongly recommended way of installing AUCTeX is by using
+the Emacs package manager integrated in Emacs 24 and greater (ELPA).
+Simply do 'M-x list-packages RET', mark the auctex package for
+installation with 'i', and hit 'x' to execute the installation
+procedure. That's all. This installation procedure has several
+advantages. Besides being platform and OS independent, you will receive
+intermediate releases between major AUCTeX releases conveniently. For
+past ELPA releases, see <https://elpa.gnu.org/packages/auctex.html>.
+Once the installation is completed, you can skip the rest of this
+section and proceed to *note Quick Start::.
The remainder of this section is about installing AUCTeX from a
release tarball or from a checkout of the AUCTeX repository.
@@ -1154,15 +1159,19 @@ These installation instructions are available in this
manual as well,
keystrokes are written in Emacs manuals. If not, have a look at the
Emacs Tutorial in the Help menu.
- If AUCTeX is installed, you might still need to activate it, by
-inserting
+ If AUCTeX is installed in any other way than from the Emacs package
+manager (ELPA), you might still need to activate it, by inserting
(load "auctex.el" nil t t)
- in your user init file.(1) If you've installed AUCTeX from the Emacs
-package manager (ELPA), you must not have this line in your user init
-file. The installation procedure already cares about loading AUCTeX
-correctly.
+ in your user init file.(1)
+
+ If AUCTeX is installed from ELPA, the installation procedure already
+cares about loading AUCTeX correctly and you *must not* have the line
+above in your init file. Note that this also applies if you have the
+following line in your init file
+
+ (package-initialize)
In order to get support for many of the LaTeX packages you will use
in your documents, you should enable document parsing as well, which can
@@ -2161,21 +2170,61 @@ File: auctex.info, Node: Completion, Next: Marking,
Prev: Mathematics, Up: E
2.6 Completion
==============
-Emacs lisp programmers probably know the 'lisp-complete-symbol' command,
-usually bound to 'M-<TAB>'. Users of the wonderful ispell mode know and
-love the 'ispell-complete-word' command from that package. Similarly,
-AUCTeX has a 'TeX-complete-symbol' command, by default bound to
-'M-<TAB>' which is equivalent to 'M-C-i'. Using 'TeX-complete-symbol'
-makes it easier to type and remember the names of long LaTeX macros.
+Emacs lisp programmers probably know the 'lisp-complete-symbol' command
+which was bound to 'M-<TAB>' until completion-at-point became the new
+standard completion facility (see below). Users of the wonderful ispell
+mode know and love the 'ispell-complete-word' command from that package.
+Similarly, AUCTeX has a 'TeX-complete-symbol' command, by default bound
+to 'M-<TAB>' which is equivalent to 'M-C-i'. Using
+'TeX-complete-symbol' makes it easier to type and remember the names of
+long LaTeX macros.
In order to use 'TeX-complete-symbol', you should write a backslash
and the start of the macro. Typing 'M-<TAB>' will now complete as much
of the macro, as it unambiguously can. For example, if you type
''
enewc'' and then 'M-<TAB>', it will expand to ''
enewcommand''.
+But there's more: if point is just after 'egin{', then
+'TeX-complete-symbol' will complete LaTeX environments, etc. This is
+controlled by 'TeX-complete-list'.
-- Command: TeX-complete-symbol
('M-<TAB>') Complete TeX symbol before point.
+ -- Variable: TeX-complete-list
+ List of ways to complete the preceding text.
+
+ Each entry is a list with the following elements:
+
+ 1. Regexp matching the preceding text or a predicate of arity 0
+ which returns non-nil and sets 'match-data' appropriately if
+ it is applicable.
+ 2. A number indicating the subgroup in the regexp containing the
+ text.
+ 3. A function returning an alist of possible completions.
+ 4. Text to append after a succesful completion.
+
+ Or alternatively:
+
+ 1. Regexp matching the preceding text.
+ 2. Function to do the actual completion.
+
+ More recent Emacs versions have a new completion mechanism. Modes
+may define and register custom completion-at-point functions and when
+the user invokes 'completion-at-point' (usually bound to 'M-<TAB>'), all
+such registered functions are consulted for checking for possible
+completions. Modern completion UIs like company-mode support this
+completion-at-point facility.
+
+ -- Function: TeX--completion-at-point
+ AUCTeX's completion-at-point function which is automatically added
+ to 'completion-at-point-functions' in TeX and LaTeX buffers.
+
+ It offers the same completion candidates as would
+ 'TeX-complete-symbol' (and is also controlled by
+ 'TeX-complete-list') except that it doesn't fall back on
+ 'ispell-complete-word' which would be awkward with completion UIs
+ like company-mode.
+
A more direct way to insert a macro is with 'TeX-insert-macro', bound
to 'C-c C-m' which is equivalent to 'C-c <RET>'. It has the advantage
over completion that it knows about the argument of most standard LaTeX
@@ -3029,19 +3078,44 @@ variables 'font-latex-fontify-script' and
'font-latex-script-display'.
this means that the scripts are raised or lowered.
Another possiblity is setting this variable to the symbol
- 'multi-level'. In this case, in a formula '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.
+ 'multi-level'. In this case, in a formula x^{y^z}, y is raised
+ above and smaller than x, and z is raised above and smaller than y.
+ With many script levels, the text might become too small to be
+ readable. (See 'font-latex-fontify-script-max-level' below.)
Lastly, you can set this variable to 'invisible' whose behavior is
like 'multi-level', and in addition the super-/subscript characters
- '^' and '_' are not displayed.
+ ^ and _ 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.
+ -- User Option: font-latex-fontify-script-max-level
+ Maximum scriptification level for which script faces are applied.
+
+ The faces 'font-latex-superscript-face' and
+ 'font-latex-subscript-face' define custom ':height' values < 1.0.
+ Therefore, scripts are displayed with a slightly smaller font than
+ normal math text. If 'font-latex-fontify-script' is 'multi-level'
+ or 'invisible', the font size becomes too small to be readable
+ after a few levels. This option allows to specify the maximum
+ level after which the size of the script text won’t be shrunken
+ anymore.
+
+ For example, in the expression x^{y^{z^a_b}}, x has scriptification
+ level 0, y has level 1, z has level 2, and both a and b have
+ scriptification level 3.
+
+ If 'font-latex-fontify-script-max-level' was 2, then z, a, and b
+ would have the same font size. If it was 3 or more, then a and b
+ were smaller than z just in the same way as z is smaller than y and
+ y is smaller than x.
+
+ The script characters '^' and '_' themselves are also fontified with
+an own face named 'font-latex-script-char-face'.
+
-- User Option: font-latex-script-display
Display specification for subscript and superscript content. The
car is used for subscript, the cdr is used for superscript. The
@@ -5355,8 +5429,8 @@ overwrite the default prompt.
Prompt for a LaTeX savebox completing with known saveboxes.
'TeX-arg-file'
- Prompt for a filename in the current directory, and use it without
- the extension.
+ Prompt for a filename in the current directory, and use it with the
+ extension.
'TeX-arg-file-name'
Prompt for a filename and use as initial input the name of the file
@@ -5749,7 +5823,7 @@ A.1 Copying this Manual
The copyright notice for this manual is:
- This manual is for AUCTeX (version 11.89.8 from 2016-12-22), a
+ This manual is for AUCTeX (version 11.90.0 from 2017-01-11), a
sophisticated TeX environment for Emacs.
Copyright (C) 1992-1995, 2001, 2002, 2004-2016 Free Software
@@ -6256,18 +6330,34 @@ File: auctex.info, Node: Changes, Next: Development,
Prev: Copying this Manua
A.2 Changes and New Features
============================
-News since 11.89
-----------------
+News in 11.90
+-------------
- * The style 'graphicx.el' went through a bigger overhaul. The
- optional argument of command '\includegraphics' now supports
- key-val query; keys can independently be chosen anytime by pressing
- the <,> key. As a side effect, the variable
- 'LaTeX-includegraphics-options-alist' is now no-op and is removed
- from 'tex-style.el'. You can safely remove any customization of it
- from your init file. The mandatory argument of '\includegraphics'
- knows about image file extensions supported by the used engine and
- offers them for inclusion.
+ * In addition to the completion performed by 'TeX-complete-symbol',
+ AUCTeX now also supports the new Emacs standard completion-at-point
+ facility (see the Emacs command 'completion-at-point'). This also
+ means that modern completion UIs like company-mode work out of the
+ box in TeX and LaTeX buffers. *Note Completion::, for details.
+
+ * Completion is now aware of being inside a math environment and then
+ completes math macros.
+
+ * AUCTeX is able to display several levels of super- and subscripts,
+ each one raised above and a bit smaller than its basis. For this
+ feature, have a look at the customize options
+ 'font-latex-fontify-script' (especially the new values
+ 'multi-level' and 'invisible') and
+ 'font-latex-fontify-script-max-level'. Also, the script characters
+ '^' and '_' are also fontified with a special face named
+ 'font-latex-script-char-face'. *Note Fontification of math::, for
+ details.
+
+ * Parsing of format specification in various tabular environments has
+ been improved. The function 'LaTeX-insert-item' ('C-c <LFD>')
+ inserts suitable number of ampersands for '*{num}{cols}'
+ constructs. Style files for LaTeX packages 'tabularx', 'tabulary',
+ 'longtable', 'dcolumn' and 'siunitx' are adapted to take advantage
+ of this improvement.
* AUCTeX has a new Ispell dictionary 'tex-ispell.el' for macros and
environments which will be skipped during spell checking. The
@@ -6279,10 +6369,6 @@ News since 11.89
is currently only used by Evince and Atril inverse search to raise
the Emacs frame.
- * AUCTeX now has limited support for the TikZ package. For the
- moment, this includes some basic support for prompting the user of
- arguments to the '\draw' macro.
-
* When inserting a new float, AUCTeX will now prompt for a
short-caption if the length of the caption provided is greater than
a certain size. This size is controlled via a new user option
@@ -6323,6 +6409,33 @@ News since 11.89
documentation with 'texdoc' has been added. 'TeX-doc' is still
available but now 'C-c ?' runs 'TeX-documentation-texdoc'.
+ * AUCTeX has a new custom option
+ 'LaTeX-reftex-cite-format-auto-activate' which controls the
+ automatic activation of citation formats provided by RefTeX when a
+ style file is loaded and RefTeX is enabled. Currently,
+ 'biblatex.el', 'harvard.el', 'jurabib.el' and 'natbib.el' use this
+ feature. If you have customized 'reftex-cite-format' and want to
+ use your settings, you should set this variable to 'nil'.
+
+ * AUCTeX now has limited support for the TikZ package. For the
+ moment, this includes some basic support for prompting the user of
+ arguments to the '\draw' macro.
+
+ * The style 'graphicx.el' went through a bigger overhaul. The
+ optional argument of command '\includegraphics' now supports
+ key-val query; keys can independently be chosen anytime by pressing
+ the <,> key. As a side effect, the variable
+ 'LaTeX-includegraphics-options-alist' is now no-op and is removed
+ from 'tex-style.el'. You can safely remove any customization of it
+ from your init file. The mandatory argument of '\includegraphics'
+ knows about image file extensions supported by the used engine and
+ offers them for inclusion.
+
+ * Support for other LaTeX packages was improved, and style files for
+ several new packages were added.
+
+ * Many bugs were crushed along the way.
+
News in 11.89
-------------
@@ -7706,7 +7819,7 @@ Key Index
* C-c C-f C-t <1>: Font Specifiers. (line 34)
* C-c C-k: Control. (line 10)
* C-c C-l: Control. (line 14)
-* C-c C-m: Completion. (line 29)
+* C-c C-m: Completion. (line 69)
* C-c C-n: Parsing Files. (line 44)
* C-c C-o b: Folding. (line 122)
* C-c C-o C-b: Folding. (line 44)
@@ -7752,7 +7865,7 @@ Key Index
* M-C-h: Marking (Texinfo). (line 34)
* M-g p: Debugging. (line 27)
* M-q: Filling. (line 89)
-* M-<TAB>: Completion. (line 19)
+* M-<TAB>: Completion. (line 24)
* <TAB>: Indenting. (line 69)
@@ -7810,6 +7923,7 @@ Function Index
* LaTeX-section-title: Sectioning. (line 72)
* LaTeX-section-toc: Sectioning. (line 75)
* plain-TeX-mode: Modes and Hooks. (line 21)
+* TeX--completion-at-point: Completion. (line 51)
* TeX-add-style-hook: Simple Style. (line 33)
* TeX-add-symbols: Adding Macros. (line 24)
* TeX-arg-bibliography: Adding Macros. (line 210)
@@ -7859,10 +7973,10 @@ Function Index
* TeX-command-run-all: Starting a Command. (line 58)
* TeX-comment-or-uncomment-paragraph: Commenting. (line 22)
* TeX-comment-or-uncomment-region: Commenting. (line 14)
-* TeX-complete-symbol: Completion. (line 18)
+* TeX-complete-symbol: Completion. (line 23)
* TeX-declare-expert-macros: Adding Macros. (line 261)
* TeX-documentation-texdoc: Documentation. (line 6)
-* TeX-electric-macro: Completion. (line 66)
+* TeX-electric-macro: Completion. (line 106)
* TeX-error-overview: Error overview. (line 11)
* TeX-fold-buffer: Folding. (line 43)
* TeX-fold-clearout-buffer: Folding. (line 121)
@@ -7882,7 +7996,7 @@ Function Index
* TeX-home-buffer: Control. (line 17)
* TeX-insert-braces: Quotes. (line 118)
* TeX-insert-dollar: Quotes. (line 60)
-* TeX-insert-macro: Completion. (line 28)
+* TeX-insert-macro: Completion. (line 68)
* TeX-insert-quote: Quotes. (line 14)
* TeX-interactive-mode: Processor Options. (line 29)
* TeX-ispell-tex-arg-end: Selecting a Command. (line 165)
@@ -7933,6 +8047,8 @@ Variable Index
(line 162)
* font-latex-fontify-script: Fontification of math.
(line 20)
+* font-latex-fontify-script-max-level: Fontification of math.
+ (line 39)
* font-latex-fontify-sectioning: Fontification of macros.
(line 95)
* font-latex-match-bold-command-keywords: Fontification of macros.
@@ -7980,7 +8096,7 @@ Variable Index
* font-latex-quotes: Fontification of quotes.
(line 15)
* font-latex-script-display: Fontification of math.
- (line 38)
+ (line 63)
* font-latex-sectioning-0-face: Fontification of macros.
(line 96)
* font-latex-sectioning-1-face: Fontification of macros.
@@ -8117,16 +8233,17 @@ Variable Index
* TeX-command-list <1>: Starting a Command. (line 32)
* TeX-command-list <2>: Selecting a Command. (line 14)
* TeX-complete-expert-commands: Environments. (line 78)
-* TeX-complete-expert-commands <1>: Completion. (line 100)
+* TeX-complete-expert-commands <1>: Completion. (line 140)
+* TeX-complete-list: Completion. (line 26)
* TeX-date-format: Adding Macros. (line 123)
* TeX-debug-bad-boxes: Ignoring warnings. (line 10)
* TeX-debug-warnings: Ignoring warnings. (line 15)
-* TeX-default-macro: Completion. (line 51)
+* TeX-default-macro: Completion. (line 91)
* TeX-default-mode: Japanese. (line 6)
* TeX-default-mode <1>: Japanese. (line 21)
* TeX-display-help: Debugging. (line 47)
* TeX-DVI-via-PDFTeX: Processor Options. (line 22)
-* TeX-electric-escape: Completion. (line 58)
+* TeX-electric-escape: Completion. (line 98)
* TeX-electric-math: Quotes. (line 72)
* TeX-electric-sub-and-superscript: Mathematics. (line 68)
* TeX-engine: Processor Options. (line 103)
@@ -8157,9 +8274,9 @@ Variable Index
* TeX-header-end <1>: Starting a Command. (line 69)
* TeX-ignore-file: Automatic. (line 52)
* TeX-ignore-warnings: Ignoring warnings. (line 25)
-* TeX-insert-braces: Completion. (line 76)
-* TeX-insert-braces-alist: Completion. (line 79)
-* TeX-insert-macro-default-style: Completion. (line 36)
+* TeX-insert-braces: Completion. (line 116)
+* TeX-insert-braces-alist: Completion. (line 119)
+* TeX-insert-macro-default-style: Completion. (line 76)
* TeX-install-font-lock: Font Locking. (line 13)
* TeX-interactive-mode: Processor Options. (line 30)
* TeX-ispell-extend-skip-list: Selecting a Command. (line 82)
@@ -8232,7 +8349,7 @@ Concept Index
* egin: Environments. (line 6)
*
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [AUCTeX-diffs] [elpa] externals/auctex f0cb472: Release GNU AUCTeX 11.90.0,
Tassilo Horn <=