branch: externals/auctex commit b3d4dfd77833af015befa31c767688ae6432a84b Author: Tassilo Horn <t...@gnu.org> Commit: Tassilo Horn <t...@gnu.org>
Release GNU AUCTeX 13.1.7 * GNU AUCTeX Version 13.1.7 released. --- README | 80 ++++++++++----------- auctex.el | 2 +- auctex.info | 205 +++++++++++++++++++++++++++-------------------------- preview-latex.info | 82 ++++++++++----------- tex-site.el | 4 +- 5 files changed, 187 insertions(+), 186 deletions(-) diff --git a/README b/README index d462bfb21d..efa58ff3aa 100644 --- a/README +++ b/README @@ -34,18 +34,18 @@ several files. One component of AUCTeX that LaTeX users will find attractive is preview-latex, a combination of folding and in-source previewing that -provides true "What You See Is What You Get" experience in your +provides true “What You See Is What You Get” experience in your sourcebuffer, while letting you retain full control. For more information, see further below. More detailed information about the features and usage of AUCTeX can be found in the AUCTeX manual. You can access it from within Emacs by -typing 'C-h i d m auctex <RET>'. If you prefer the standalone info -reader, issue the command 'info auctex' in a terminal. +typing ‘C-h i d m auctex <RET>’. If you prefer the standalone info +reader, issue the command ‘info auctex’ in a terminal. AUCTeX is written entirely in Emacs Lisp, and hence you can easily add new features for your own needs. It is a GNU project and distributed -under the 'GNU General Public License Version 3'. +under the ‘GNU General Public License Version 3’. The most recent version is always available at <https://ftp.gnu.org/pub/gnu/auctex/>. @@ -54,20 +54,20 @@ WWW users may want to check out the AUCTeX page at <https://www.gnu.org/software/auctex/>. For comprehensive information about how to install AUCTeX read the file -'INSTALL' or 'INSTALL.windows', respectively. +‘INSTALL’ or ‘INSTALL.windows’, respectively. If you are considering upgrading AUCTeX, the recent changes are -described in the 'CHANGES' file. +described in the ‘CHANGES’ file. If you want to discuss AUCTeX with other users or its developers, there are several mailing lists you can use. -Send a mail with the subject "subscribe" to <auctex-requ...@gnu.org> in +Send a mail with the subject “subscribe” to <auctex-requ...@gnu.org> in order to join the general discussion list for AUCTeX. Articles should be sent to <auc...@gnu.org>. In a similar way, you can subscribe to the <info-auc...@gnu.org> list for just getting important announcements about AUCTeX. The list <bug-auc...@gnu.org> is for bug reports which -you should usually file with the 'M-x TeX-submit-bug-report <RET>' +you should usually file with the ‘M-x TeX-submit-bug-report <RET>’ command. If you want to address the developers of AUCTeX themselves with technical issues, they can be found on the discussion list <auctex-de...@gnu.org>. @@ -88,19 +88,19 @@ between source and image representation. WYSIWYG (what you see is what you get) sometimes is considered all the rage, sometimes frowned upon. Do we really want it? Wrong question. The right question is _what_ we want from it. Except when finetuning -the layout, we don't want to use printer fonts for on-screen text +the layout, we don’t want to use printer fonts for on-screen text editing. The low resolution and contrast of a computer screen render all but the coarsest printer fonts (those for low-quality newsprint) unappealing, and the margins and pagination of the print are not wanted on the screen, either. On the other hand, more complex visual -compositions like math formulas and tables can't easily be taken in when +compositions like math formulas and tables can’t easily be taken in when seen only in the source. preview-latex strikes a balance: it only uses graphic renditions of the output for certain, configurable constructs, does this only when told, and then right in the source code. Switching back and forth between the source and preview is easy and natural and can be done for each image independently. Behind the scenes of preview-latex, a sophisticated framework of other programs like -'dvipng', Dvips and Ghostscript are employed together with a special +‘dvipng’, Dvips and Ghostscript are employed together with a special LaTeX style file for extracting the material of interest in the background and providing fast interactive response. @@ -116,22 +116,22 @@ The usual activation (if it is not done automatically) would be (load "preview-latex.el" nil t t) -If you still don't get a "Preview" menu in LaTeX mode in spite of AUCTeX -showing its "Command", your installation is broken. One possible cause -are duplicate Lisp files that might be detectable with 'M-x -list-load-path-shadows <RET>'. +If you still don’t get a “Preview” menu in LaTeX mode in spite of AUCTeX +showing its “Command”, your installation is broken. One possible cause +are duplicate Lisp files that might be detectable with ‘M-x +list-load-path-shadows <RET>’. 3 Getting started ***************** Once activated, preview-latex and its documentation will be accessible via its menus (note that preview-latex requires AUCTeX to be loaded). -When you have loaded a LaTeX document (a sample document 'circ.tex' is +When you have loaded a LaTeX document (a sample document ‘circ.tex’ is included in the distribution, but most documents including math and/or -figures should do), you can use its menu or 'C-c C-p C-d' (for -'Preview/Document'). Previews will now be generated for various objects +figures should do), you can use its menu or ‘C-c C-p C-d’ (for +‘Preview/Document’). Previews will now be generated for various objects in your document. You can use the time to take a short look at the -other menu entries and key bindings in the 'Preview' menu. You'll see +other menu entries and key bindings in the ‘Preview’ menu. You’ll see the previewed objects change into a roadworks sign when preview-latex has determined just what it is going to preview. Note that you can freely navigate the buffer while this is going on. When the process is @@ -142,24 +142,24 @@ appear, since that is the moment when the correlation between the original text and the buffer locations gets established. If the buffer changes before that point of time, the previews will not be placed where they belong. If you do want to change some obvious error you just -spotted, we recommend you stop the background process by pressing 'C-c -C-k'. +spotted, we recommend you stop the background process by pressing ‘C-c +C-k’. To see/edit the LaTeX code for a specific object, put the point (the -cursor) on it and press 'C-c C-p C-p' (for 'Preview/at point'). It will +cursor) on it and press ‘C-c C-p C-p’ (for ‘Preview/at point’). It will also do to click with the middle mouse button on the preview. Now you -can edit the code, and generate a new preview by again pressing 'C-c C-p -C-p' (or by clicking with the middle mouse button on the icon before the +can edit the code, and generate a new preview by again pressing ‘C-c C-p +C-p’ (or by clicking with the middle mouse button on the icon before the edited text). -If you are using the 'desktop' package, previews will remain from one -session to the next as long as you don't kill your buffer. +If you are using the ‘desktop’ package, previews will remain from one +session to the next as long as you don’t kill your buffer. 4 Basic modes of operation ************************** preview-latex has a number of methods for generating its graphics. Its -default operation is equivalent to using the 'LaTeX' command from +default operation is equivalent to using the ‘LaTeX’ command from AUCTeX. If this happens to be a call of PDFLaTeX generating PDF output (you need at least AUCTeX 11.51 for this), then Ghostscript will be called directly on the resulting PDF file. If a DVI file gets produced, @@ -169,10 +169,10 @@ The image type to be generated by Ghostscript can be configured with M-x customize-option <RET> preview-image-type <RET> -The default is 'png' (the most efficient image type). A special setting -is 'dvipng' in case you have the 'dvipng' program installed. In this -case, 'dvipng' will be used for converting DVI files and Ghostscript -(with a 'PNG' device) for converting PDF files. 'dvipng' is much faster +The default is ‘png’ (the most efficient image type). A special setting +is ‘dvipng’ in case you have the ‘dvipng’ program installed. In this +case, ‘dvipng’ will be used for converting DVI files and Ghostscript +(with a ‘PNG’ device) for converting PDF files. ‘dvipng’ is much faster than the combination of Dvips and Ghostscript. You can get downloads, access to its CVS archive and further information from its project site (https://savannah.nongnu.org/projects/dvipng). @@ -185,15 +185,15 @@ be available. You can access it with the standalone info reader with info preview-latex -or by pressing 'C-h i d m preview-latex <RET>' in Emacs. Once -preview-latex is activated, you can instead use 'C-c C-p <TAB>' (or the -menu entry 'Preview/Read documentation'). +or by pressing ‘C-h i d m preview-latex <RET>’ in Emacs. Once +preview-latex is activated, you can instead use ‘C-c C-p <TAB>’ (or the +menu entry ‘Preview/Read documentation’). Depending on your installation, a printable manual may also be available -in the form of 'preview-latex.pdf'. +in the form of ‘preview-latex.pdf’. Detailed documentation for the LaTeX style used for extracting the -preview images is placed in 'preview.pdf' in a suitable directory during +preview images is placed in ‘preview.pdf’ in a suitable directory during installation; on typical TeX Live-based systems, texdoc preview @@ -218,7 +218,7 @@ interface. 7 Contacts ********** -Bug reports should be sent by using 'M-x preview-report-bug <RET>', as +Bug reports should be sent by using ‘M-x preview-report-bug <RET>’, as this will fill in a lot of information interesting to us. If the installation fails (but this should be a rare event), report bugs to <bug-auc...@gnu.org>. @@ -226,15 +226,15 @@ installation fails (but this should be a rare event), report bugs to There is a general discussion list for AUCTeX which also covers preview-latex, look at <https://lists.gnu.org/mailman/listinfo/auctex>. For more information on the mailing list, send a message with just the -word "help" as subject or body to <auctex-requ...@gnu.org>. For the +word “help” as subject or body to <auctex-requ...@gnu.org>. For the developers, there is the <auctex-de...@gnu.org> list; it would probably make sense to direct feature requests and questions about internal details there. There is a low-volume read-only announcement list -available to which you can subscribe by sending a mail with "subscribe" +available to which you can subscribe by sending a mail with “subscribe” in the subject to <info-auctex-requ...@gnu.org>. Offers to support further development will be appreciated. If you want to show your appreciation with a donation to the main developer, you can do so via PayPal to <d...@gnu.org>, and of course you can arrange for -service contracts or for added functionality. Take a look at the 'TODO' +service contracts or for added functionality. Take a look at the ‘TODO’ list for suggestions in that area. diff --git a/auctex.el b/auctex.el index d2cb07e05d..ae98eb2af8 100644 --- a/auctex.el +++ b/auctex.el @@ -2,7 +2,7 @@ ;; Copyright (C) 2014-2021 Free Software Foundation, Inc. -;; Version: 13.1.6 +;; Version: 13.1.7 ;; URL: https://www.gnu.org/software/auctex/ ;; Maintainer: auctex-de...@gnu.org ;; Notifications-To: auctex-di...@gnu.org diff --git a/auctex.info b/auctex.info index 1c77295f29..1cb2eb9dbd 100644 --- a/auctex.info +++ b/auctex.info @@ -1,6 +1,7 @@ -This is auctex.info, produced by makeinfo version 7.0 from auctex.texi. +This is auctex.info, produced by makeinfo version 7.0.1 from +auctex.texi. -This manual is for AUCTeX (version 13.1.6 from 2022-11-18), a +This manual is for AUCTeX (version 13.1.7 from 2023-01-13), a sophisticated TeX environment for Emacs. Copyright © 1992-1995, 2001, 2002, 2004-2022 Free Software @@ -6180,7 +6181,7 @@ A.1 Copying this Manual The copyright notice for this manual is: - This manual is for AUCTeX (version 13.1.6 from 2022-11-18), a + This manual is for AUCTeX (version 13.1.7 from 2023-01-13), a sophisticated TeX environment for Emacs. Copyright © 1992-1995, 2001, 2002, 2004-2022 Free Software @@ -9659,105 +9660,105 @@ Concept Index Tag Table: -Node: Top920 -Node: Copying7400 -Node: Introduction9349 -Node: Summary9619 -Node: Installation12368 -Node: Prerequisites14379 -Node: Configure16606 -Node: Build/install and uninstall21348 -Node: Loading the package22105 -Node: Advice for package providers23844 -Node: Advice for non-privileged users26715 -Node: Installation under MS Windows32233 -Node: Customizing46173 -Node: Quick Start47782 -Ref: Quick Start-Footnote-149915 -Node: Editing Facilities50017 -Node: Processing Facilities54907 -Node: Editing59798 -Node: Quotes61136 -Node: Font Specifiers70674 -Node: Sectioning72870 -Node: Environments77567 -Node: Equations83135 -Node: Floats83763 -Node: Itemize-like85807 -Node: Tabular-like86677 -Node: Customizing Environments88571 -Node: Mathematics88811 -Node: Completion92337 -Node: Marking100104 -Node: Marking (LaTeX)100740 -Node: Marking (Texinfo)101690 -Node: Commenting103333 -Node: Indenting104718 -Node: Filling112670 -Node: Display118692 -Node: Font Locking121205 -Node: Fontification of macros123310 -Node: Fontification of quotes133313 -Node: Fontification of math134853 -Node: Verbatim content138629 -Node: Faces139419 -Node: Known problems139924 -Node: Folding140933 -Node: Outline151920 -Node: Narrowing153243 -Node: Prettifying154320 -Node: Processing155607 -Node: Commands156967 -Node: Starting a Command157531 -Node: Selecting a Command162695 -Node: Processor Options172098 -Node: Viewing182771 -Node: Starting Viewers183145 -Node: I/O Correlation188943 -Ref: I/O Correlation-Footnote-1194701 -Node: Debugging194967 -Node: Ignoring warnings197647 -Node: Error overview199758 -Node: Checking201682 -Node: Control203372 -Node: Cleaning205521 -Node: Documentation206968 -Node: Customization207695 -Node: Modes and Hooks208188 -Node: Multifile210148 -Node: Parsing Files214994 -Node: Internationalization220033 -Node: European221387 -Node: Japanese229306 -Node: Automatic234566 -Node: Automatic Global237095 -Node: Automatic Private238233 -Node: Automatic Local239597 -Node: Style Files240871 -Node: Simple Style241685 -Node: Adding Macros245478 -Node: Adding Environments255279 -Node: Adding Other260741 -Node: Hacking the Parser265421 -Node: Appendices269434 -Node: Copying this Manual269730 -Node: GNU Free Documentation License270616 -Node: Changes295940 -Node: Development355332 -Node: Mid-term Goals355980 -Node: Wishlist358879 -Node: Bugs365082 -Node: FAQ366222 -Node: Texinfo mode372096 -Node: Exploiting373232 -Node: Superseding374054 -Node: Mapping378521 -Node: Unbinding380464 -Node: Indices381305 -Node: Key Index381468 -Node: Function Index389143 -Node: Variable Index401413 -Node: Concept Index426845 +Node: Top922 +Node: Copying7402 +Node: Introduction9351 +Node: Summary9621 +Node: Installation12370 +Node: Prerequisites14381 +Node: Configure16608 +Node: Build/install and uninstall21350 +Node: Loading the package22107 +Node: Advice for package providers23846 +Node: Advice for non-privileged users26717 +Node: Installation under MS Windows32235 +Node: Customizing46175 +Node: Quick Start47784 +Ref: Quick Start-Footnote-149917 +Node: Editing Facilities50019 +Node: Processing Facilities54909 +Node: Editing59800 +Node: Quotes61138 +Node: Font Specifiers70676 +Node: Sectioning72872 +Node: Environments77569 +Node: Equations83137 +Node: Floats83765 +Node: Itemize-like85809 +Node: Tabular-like86679 +Node: Customizing Environments88573 +Node: Mathematics88813 +Node: Completion92339 +Node: Marking100106 +Node: Marking (LaTeX)100742 +Node: Marking (Texinfo)101692 +Node: Commenting103335 +Node: Indenting104720 +Node: Filling112672 +Node: Display118694 +Node: Font Locking121207 +Node: Fontification of macros123312 +Node: Fontification of quotes133315 +Node: Fontification of math134855 +Node: Verbatim content138631 +Node: Faces139421 +Node: Known problems139926 +Node: Folding140935 +Node: Outline151922 +Node: Narrowing153245 +Node: Prettifying154322 +Node: Processing155609 +Node: Commands156969 +Node: Starting a Command157533 +Node: Selecting a Command162697 +Node: Processor Options172100 +Node: Viewing182773 +Node: Starting Viewers183147 +Node: I/O Correlation188945 +Ref: I/O Correlation-Footnote-1194703 +Node: Debugging194969 +Node: Ignoring warnings197649 +Node: Error overview199760 +Node: Checking201684 +Node: Control203374 +Node: Cleaning205523 +Node: Documentation206970 +Node: Customization207697 +Node: Modes and Hooks208190 +Node: Multifile210150 +Node: Parsing Files214996 +Node: Internationalization220035 +Node: European221389 +Node: Japanese229308 +Node: Automatic234568 +Node: Automatic Global237097 +Node: Automatic Private238235 +Node: Automatic Local239599 +Node: Style Files240873 +Node: Simple Style241687 +Node: Adding Macros245480 +Node: Adding Environments255281 +Node: Adding Other260743 +Node: Hacking the Parser265423 +Node: Appendices269436 +Node: Copying this Manual269732 +Node: GNU Free Documentation License270618 +Node: Changes295942 +Node: Development355334 +Node: Mid-term Goals355982 +Node: Wishlist358881 +Node: Bugs365084 +Node: FAQ366224 +Node: Texinfo mode372098 +Node: Exploiting373234 +Node: Superseding374056 +Node: Mapping378523 +Node: Unbinding380466 +Node: Indices381307 +Node: Key Index381470 +Node: Function Index389145 +Node: Variable Index401415 +Node: Concept Index426847 End Tag Table diff --git a/preview-latex.info b/preview-latex.info index 2e8c180cd9..51df678d6c 100644 --- a/preview-latex.info +++ b/preview-latex.info @@ -1,8 +1,8 @@ -This is preview-latex.info, produced by makeinfo version 7.0 from +This is preview-latex.info, produced by makeinfo version 7.0.1 from preview-latex.texi. This manual is for preview-latex, a LaTeX preview mode for AUCTeX -(version 13.1.6 from 2022-11-18). +(version 13.1.7 from 2023-01-13). Copyright © 2001, 2002, 2003, 2004, 2005, 2006, 2017-2019, 2021 Free Software Foundation, Inc. @@ -1922,7 +1922,7 @@ Appendix C Copying this Manual The copyright notice for this manual is: This manual is for preview-latex, a LaTeX preview mode for AUCTeX -(version 13.1.6 from 2022-11-18). +(version 13.1.7 from 2023-01-13). Copyright © 2001, 2002, 2003, 2004, 2005, 2006, 2017-2019, 2021 Free Software Foundation, Inc. @@ -2550,44 +2550,44 @@ Index Tag Table: -Node: Top962 -Node: Copying2242 -Node: Introduction2696 -Node: What use is it?3370 -Node: Activating preview-latex4767 -Node: Getting started5532 -Node: Basic modes of operation7519 -Node: More documentation8752 -Node: Availability9641 -Node: Contacts10368 -Node: Installation11657 -Node: Keys and lisp11858 -Node: Simple customization19137 -Node: Known problems24961 -Node: Font problems with Dvips25847 -Node: Too small bounding boxes27057 -Node: x-symbol interoperation28481 -Node: Middle-clicks paste instead of toggling29905 -Node: No images are displayed with gs 9.27 and earlier30602 -Node: Black texts are too hard to read on dark background33360 -Node: For advanced users34017 -Node: The LaTeX style file34476 -Node: Package options37062 -Node: Provided commands48288 -Node: The Emacs interface55895 -Node: The preview images64859 -Node: Misplaced previews68744 -Node: ToDo72272 -Node: Frequently Asked Questions77109 -Node: Introduction to FAQ77432 -Node: Requirements77771 -Node: Installation Trouble79757 -Node: Customization82049 -Node: Troubleshooting85177 -Node: Other formats87691 -Node: Copying this Manual89040 -Node: GNU Free Documentation License89989 -Node: Index115316 +Node: Top964 +Node: Copying2244 +Node: Introduction2698 +Node: What use is it?3372 +Node: Activating preview-latex4769 +Node: Getting started5534 +Node: Basic modes of operation7521 +Node: More documentation8754 +Node: Availability9643 +Node: Contacts10370 +Node: Installation11659 +Node: Keys and lisp11860 +Node: Simple customization19139 +Node: Known problems24963 +Node: Font problems with Dvips25849 +Node: Too small bounding boxes27059 +Node: x-symbol interoperation28483 +Node: Middle-clicks paste instead of toggling29907 +Node: No images are displayed with gs 9.27 and earlier30604 +Node: Black texts are too hard to read on dark background33362 +Node: For advanced users34019 +Node: The LaTeX style file34478 +Node: Package options37064 +Node: Provided commands48290 +Node: The Emacs interface55897 +Node: The preview images64861 +Node: Misplaced previews68746 +Node: ToDo72274 +Node: Frequently Asked Questions77111 +Node: Introduction to FAQ77434 +Node: Requirements77773 +Node: Installation Trouble79759 +Node: Customization82051 +Node: Troubleshooting85179 +Node: Other formats87693 +Node: Copying this Manual89042 +Node: GNU Free Documentation License89991 +Node: Index115318 End Tag Table diff --git a/tex-site.el b/tex-site.el index 7090cc103e..905a22b3bb 100644 --- a/tex-site.el +++ b/tex-site.el @@ -126,11 +126,11 @@ set it with `TeX-modes-set'." :set #'TeX-modes-set :initialize #'custom-initialize-reset) -(defconst AUCTeX-version "13.1.6" +(defconst AUCTeX-version "13.1.7" "AUCTeX version. If not a regular release, the date of the last change.") -(defconst AUCTeX-date "2022-11-18" +(defconst AUCTeX-date "2023-01-13" "AUCTeX release date using the ISO 8601 format, yyyy-mm-dd.") ;; Store bibitems when saving a BibTeX buffer