"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "doc/auctex.info-1" between
auctex-12.2.tar.gz and auctex-12.3.tar.gz

About: AUCTEX is an extensible package for writing and formatting TeX files in GNU Emacs and XEmacs.

auctex.info-1  (auctex-12.2):auctex.info-1  (auctex-12.3)
skipping to change at line 103 skipping to change at line 103
* Narrowing:: Restricting display and editing to a portion of the buffer * Narrowing:: Restricting display and editing to a portion of the buffer
* Prettifying:: Displaying Greek and math macros as Unicode char acters * Prettifying:: Displaying Greek and math macros as Unicode char acters
Font Locking Font Locking
* Fontification of macros:: Fontification of macros * Fontification of macros:: Fontification of macros
* Fontification of quotes:: Fontification of quotes * Fontification of quotes:: Fontification of quotes
* Fontification of math:: Fontification of math constructs * Fontification of math:: Fontification of math constructs
* Verbatim content:: Verbatim macros and environments * Verbatim content:: Verbatim macros and environments
* Faces:: Faces used by font-latex * Faces:: Faces used by font-latex
* Known problems:: Known fontification problems
Starting Processors, Viewers and Other Programs Starting Processors, Viewers and Other Programs
* Commands:: Invoking external commands. * Commands:: Invoking external commands.
* Viewing:: Invoking external viewers. * Viewing:: Invoking external viewers.
* Debugging:: Debugging TeX and LaTeX output. * Debugging:: Debugging TeX and LaTeX output.
* Checking:: Checking the document. * Checking:: Checking the document.
* Control:: Controlling the processes. * Control:: Controlling the processes.
* Cleaning:: Cleaning intermediate and output files. * Cleaning:: Cleaning intermediate and output files.
* Documentation:: Documentation about macros and packages. * Documentation:: Documentation about macros and packages.
skipping to change at line 1551 skipping to change at line 1552
If you give an argument (that is, type 'C-u') to the font command, If you give an argument (that is, type 'C-u') to the font command,
the innermost font will be replaced, i.e. the font in the TeX group the innermost font will be replaced, i.e. the font in the TeX group
around point will be changed. The following table shows the available around point will be changed. The following table shows the available
commands, with '-!-' indicating the position where the text will be commands, with '-!-' indicating the position where the text will be
inserted. inserted.
'C-c C-f C-b' 'C-c C-f C-b'
Insert bold face '\textbf{-!-}' text. Insert bold face '\textbf{-!-}' text.
'C-c C-f C-m'
Insert medium face '\textmd{-!-}' text.
'C-c C-f C-i' 'C-c C-f C-i'
Insert italics '\textit{-!-}' text. Insert italics '\textit{-!-}' text.
'C-c C-f C-e' 'C-c C-f C-e'
Insert emphasized '\emph{-!-}' text. Insert emphasized '\emph{-!-}' text.
'C-c C-f C-s' 'C-c C-f C-s'
Insert slanted '\textsl{-!-}' text. Insert slanted '\textsl{-!-}' text.
'C-c C-f C-r' 'C-c C-f C-r'
Insert roman \textrm{-!-} text. Insert roman '\textrm{-!-}' text.
'C-c C-f C-f' 'C-c C-f C-f'
Insert sans serif '\textsf{-!-}' text. Insert sans serif '\textsf{-!-}' text.
'C-c C-f C-t' 'C-c C-f C-t'
Insert typewriter '\texttt{-!-}' text. Insert typewriter '\texttt{-!-}' text.
'C-c C-f C-c' 'C-c C-f C-c'
Insert SMALL CAPS '\textsc{-!-}' text. Insert SMALL CAPS '\textsc{-!-}' text.
'C-c C-f C-l'
Insert upper lower case '\textulc{-!-}' text.
'C-c C-f C-w'
Insert SWASH '\textsw{-!-}' text.
'C-c C-f C-n'
Insert normal '\textnormal{-!-}' text.
'C-c C-f C-d' 'C-c C-f C-d'
Delete the innermost font specification containing point. Delete the innermost font specification containing point.
-- Command: TeX-font replace what -- Command: TeX-font replace what
('C-c C-f') Insert template for font change command. ('C-c C-f') Insert template for font change command.
If REPLACE is not nil, replace current font. WHAT determines the If REPLACE is not nil, replace current font. WHAT determines the
font to use, as specified by 'TeX-font-list'. font to use, as specified by 'TeX-font-list'.
-- User Option: TeX-font-list -- User Option: TeX-font-list
skipping to change at line 2937 skipping to change at line 2950
3.1.3 Fontification of mathematical constructs 3.1.3 Fontification of mathematical constructs
---------------------------------------------- ----------------------------------------------
In LaTeX mathematics can be indicated by a variety of different methods: In LaTeX mathematics can be indicated by a variety of different methods:
toggles (like dollar signs), macros and environments. Math constructs toggles (like dollar signs), macros and environments. Math constructs
known by font-latex are displayed with the face 'font-latex-math-face'. known by font-latex are displayed with the face 'font-latex-math-face'.
Support for dollar signs and shorthands like '\(...\)' or '\[...\]' is Support for dollar signs and shorthands like '\(...\)' or '\[...\]' is
built-in and not customizable. Support for other math macros and built-in and not customizable. Support for other math macros and
environments can be adapted by customizing the variables environments can be adapted by customizing the variables
'font-latex-match-math-command-keywords' and 'font-latex-match-math-command-keywords' and 'texmathp-tex-commands'
'font-latex-math-environments' respectively. respectively. It is no longer recommended to customize
'font-latex-math-environments'.
To convert your customization in 'font-latex-math-environments' into
'texmathp-tex-commands', please register your own math environments,
together with starred variants if any, as entries of 'env-on' type in
'texmathp-tex-commands', then clear out 'font-latex-math-environments'.
You have to restart Emacs for this new customization to take effect for
fontification.
In order to make math constructs more readable, font-latex displays In order to make math constructs more readable, font-latex displays
subscript and superscript parts in a smaller font and raised or lowered subscript and superscript parts in a smaller font and raised or lowered
respectively. This fontification feature can be controlled with the respectively. This fontification feature can be controlled with the
variables 'font-latex-fontify-script' and 'font-latex-script-display'. variables 'font-latex-fontify-script' and 'font-latex-script-display'.
-- User Option: font-latex-fontify-script -- User Option: font-latex-fontify-script
If non-nil, fontify subscript and superscript strings. Concretely, If non-nil, fontify subscript and superscript strings. Concretely,
this means that the scripts are raised or lowered. this means that the scripts are raised or lowered.
skipping to change at line 3035 skipping to change at line 3056
a buffer get fontified with an inappropriate face. A typical situation a buffer get fontified with an inappropriate face. A typical situation
for this to happen is the use of a dollar sign ('$') in a verbatim macro for this to happen is the use of a dollar sign ('$') in a verbatim macro
or environment. If font-latex is not aware of the verbatim construct, or environment. If font-latex is not aware of the verbatim construct,
it assumes the dollar sign to be a toggle for mathematics and fontifies it assumes the dollar sign to be a toggle for mathematics and fontifies
the following buffer content with the respective face until it finds a the following buffer content with the respective face until it finds a
closing dollar sign or till the end of the buffer. closing dollar sign or till the end of the buffer.
As a remedy you can make the verbatim construct known to font-latex, As a remedy you can make the verbatim construct known to font-latex,
*note Verbatim content::. If this is not possible, you can insert a *note Verbatim content::. If this is not possible, you can insert a
commented dollar sign ('%$') at the next suitable end of line as a quick commented dollar sign ('%$') at the next suitable end of line as a quick
workaround. workaround. In docTeX documents, '^^A$' is also available for similar
purpose.
File: auctex.info, Node: Folding, Next: Outline, Prev: Font Locking, Up: Dis play File: auctex.info, Node: Folding, Next: Outline, Prev: Font Locking, Up: Dis play
3.2 Folding Macros and Environments 3.2 Folding Macros and Environments
=================================== ===================================
A popular complaint about markup languages like TeX and LaTeX is that A popular complaint about markup languages like TeX and LaTeX is that
there is too much clutter in the source text and that one cannot focus there is too much clutter in the source text and that one cannot focus
well on the content. There are macros where you are only interested in well on the content. There are macros where you are only interested in
the content they are enclosing, like font specifiers where the content the content they are enclosing, like font specifiers where the content
skipping to change at line 3338 skipping to change at line 3360
3.5 Prettifying 3.5 Prettifying
=============== ===============
Emacs 25 is able to prettify symbols in programming language buffers, Emacs 25 is able to prettify symbols in programming language buffers,
*note (emacs)Misc for Programs::. The canonical example is to display *note (emacs)Misc for Programs::. The canonical example is to display
'(lambda () ...)' as '(λ () ...)' in Lisp buffers. '(lambda () ...)' as '(λ () ...)' in Lisp buffers.
AUCTeX can use this feature in order to display certain math macros 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 '\alpha \times \beta' will be displayed as 'α × β'. the TeX code '\alpha \times \beta' will be displayed as 'α × β'. When
When point is on one of the characters, it'll be unprettified point is on one of the characters, it'll be unprettified automatically,
automatically, meaning you see the verbatim text again. For this meaning you see the verbatim text again. For this behaviour however you
behaviour however you need to set 'prettify-symbols-unprettify-at-point' need to set 'prettify-symbols-unprettify-at-point' to t or 'right-edge'
to t or 'right-edge' which will unprettify the symbol when point moves which will unprettify the symbol when point moves into or near it.
into or near it.
To enable prettification in AUCTeX, simply add To enable prettification in AUCTeX, simply add
'prettify-symbols-mode' to 'TeX-mode-hook'. If you enabled 'prettify-symbols-mode' to 'TeX-mode-hook'. If you enabled
prettification globally with 'global-prettify-symbols-mode', then it's prettification globally with 'global-prettify-symbols-mode', then it's
automatically enabled in AUCTeX, too. automatically enabled in AUCTeX, too.
You can also add custom symbol unicode-character pairs for You can also add custom symbol unicode-character pairs for
prettification by adding to 'tex--prettify-symbols-alist'. Note that prettification by adding to 'tex--prettify-symbols-alist'. Note that
this variable is part of Emacs' stock 'tex-mode.el' and used by that and this variable is part of Emacs' stock 'tex-mode.el' and used by that and
AUCTeX. AUCTeX.
skipping to change at line 5773 skipping to change at line 5794
* FAQ:: * FAQ::
* Texinfo mode:: * Texinfo mode::
File: auctex.info, Node: Copying this Manual, Next: Changes, Up: Appendices File: auctex.info, Node: Copying this Manual, Next: Changes, Up: Appendices
A.1 Copying this Manual A.1 Copying this Manual
======================= =======================
The copyright notice for this manual is: The copyright notice for this manual is:
This manual is for AUCTeX (version 12.2 from 2019-10-26), a This manual is for AUCTeX (version 12.3 from 2020-10-10), a
sophisticated TeX environment for Emacs. sophisticated TeX environment for Emacs.
Copyright (C) 1992-1995, 2001, 2002, 2004-2019 Free Software Copyright (C) 1992-1995, 2001, 2002, 2004-2020 Free Software
Foundation, Inc. Foundation, Inc.
Permission is granted to copy, distribute and/or modify this Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License, document under the terms of the GNU Free Documentation License,
Version 1.3 or any later version published by the Free Software Version 1.3 or any later version published by the Free Software
Foundation; with no Invariant Sections, no Front-Cover Texts and no Foundation; with no Invariant Sections, no Front-Cover Texts and no
Back-Cover Texts. A copy of the license is included in the section Back-Cover Texts. A copy of the license is included in the section
entitled "GNU Free Documentation License." entitled "GNU Free Documentation License."
The full license text can be read here: The full license text can be read here:
skipping to change at line 6278 skipping to change at line 6299
If your document contains nontrivial examples of program code, we If your document contains nontrivial examples of program code, we
recommend releasing these examples in parallel under your choice of free recommend releasing these examples in parallel under your choice of free
software license, such as the GNU General Public License, to permit software license, such as the GNU General Public License, to permit
their use in free software. their use in free software.
File: auctex.info, Node: Changes, Next: Development, Prev: Copying this Manua l, Up: Appendices File: auctex.info, Node: Changes, Next: Development, Prev: Copying this Manua l, Up: Appendices
A.2 Changes and New Features A.2 Changes and New Features
============================ ============================
News in 12.3
------------
* Support for 'PSTricks' is now PDF-oriented. AUCTeX no longer turns
off PDF mode for 'PSTricks' documents even without 'pst-pdf'. It
now sets up 'TeX-PDF-from-DVI' option so that PDF output is
generated when 'TeX-PDF-mode' is enabled (default). Users who want
DVI output should disable PDF mode explicitly by file local
variable, or customize 'TeX-PDF-mode' to 'nil'.
* The function 'font-latex-update-font-lock' has been obsoleted in
order to fix 'bug#37945'. That function was used by several style
files in order to refresh fontification after adding new symbols or
verbatim constructs. It is better to call 'font-lock-flush' in the
former case and 'font-latex-set-syntactic-keywords' in the latter
case. The function 'font-latex-update-font-lock' still exists as a
no-op which only shows a warning explaining how to update font-lock
as mentioned above.
* Math expression highlighting was improved. Highlighting for
documents with a lot of inline math expressions '$...$' won't get
scrambled now ('bug#33139').
There is small incompatibility due to this fix. When odd number of
dollar signs are in a comment, the subsequent lines are highlighted
as math until another '$' appears. You can insert a commented
dollar sign ('%$') at the next suitable end of line as a
workaround. *Note Known problems::.
In addition, it is no longer recommended to customize
'font-latex-math-environments'. Use 'texmathp-tex-commands'
instead. *Note Fontification of math::.
* AUCTeX tracks changes in LaTeX2e 2020-02-02 release. AUCTeX
supports the improvements to LaTeX font selection mechanism (NFSS).
New macros like '\textsw' or '\textulc' are added to font insertion
keyboard commands. *Note Font Specifiers::, for details. Further,
the entries in the menu LaTeX, Insert Font are reorganized and
adjusted accordingly.
Macros previously provided by 'textcomp.sty' are now part of LaTeX
kernel. AUCTeX tracks this change as well and support for the new
macro '\legacyoldstylenums' is added.
* Insertion of environments in LaTeX documents (i.e. 'C-c C-e') was
improved. The former code had a few bugs, which sometimes resulted
in either spurious empty line or spurious comment prefix, or both,
especially when the region is active. Those bugs are now fixed.
* More bugs fixed, other minor features implemented.
News in 12.2 News in 12.2
------------ ------------
* AUCTeX reflects the changes in LaTeX2e 2019-10-01 release. * AUCTeX reflects the changes in LaTeX2e 2019-10-01 release.
'filecontents' environment now takes an optional argument and can 'filecontents' environment now takes an optional argument and can
be used anywhere in a document. The macros '\Ref' and be used anywhere in a document. The macros '\Ref' and
'\labelformat' are moved from 'varioref.sty' to LaTeX kernel. '\labelformat' are moved from 'varioref.sty' to LaTeX kernel.
amsmath has a new macro '\overunderset'. amsmath has a new macro '\overunderset'.
* A new method is implemented in preview-latex to adjust the * A new method is implemented in preview-latex to adjust the
 End of changes. 10 change blocks. 
12 lines changed or deleted 84 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)