main 59d74b08 250/257: Regenerate after merge from master

[Tassilo Horn]

branch: main
commit 59d74b08a5c3180f1923d6de28b939a96cac1b3e
Author: Tassilo Horn <tsdh@gnu.org>
Commit: Tassilo Horn <tsdh@gnu.org>

    Regenerate after merge from master
---
 auctex.info        | 285 ++++++++++++++++++++++++++++++++---------------------
 preview-latex.info |  80 +++++++--------
 tex-site.el        |   4 +-
 3 files changed, 213 insertions(+), 156 deletions(-)

diff --git a/auctex.info b/auctex.info
index ae94233f..961285f0 100644
--- a/auctex.info
+++ b/auctex.info
@@ -1,6 +1,6 @@
 This is auctex.info, produced by makeinfo version 7.1 from auctex.texi.
 
-This manual is for AUCTeX (version 14.0.2 from 2024-02-09), a
+This manual is for AUCTeX (version 14.0.2.2024-02-20 from 2024-02-20), a
 sophisticated TeX environment for Emacs.
 
    Copyright © 1992-1995, 2001, 2002, 2004-2024 Free Software
@@ -581,14 +581,32 @@ before the above lines into your Emacs startup file.
 providers::.
 
    Once activated, the modes provided by AUCTeX are used per default for
-all supported file types.  If you want to change the modes for which it
-is operative instead of the default, use
-     M-x customize-option <RET> TeX-modes <RET>
+all supported file types, namely ‘plain-tex-mode’, ‘latex-mode’,
+‘doctex-mode’ and ‘texinfo-mode’.  This might not match your preference.
+You can have control over which AUCTeX mode is activated per file types
+by ‘TeX-modes’ option.  For example, you can use Emacs built-in
+‘plain-tex-mode’ for plain TeX files while you can use AUCTeX
+‘LaTeX-mode’ for LaTeX files.
+
+ -- User Option: TeX-modes
+     List of Emacs built-in TeX modes redirected to AUCTeX modes.  If
+     you prefer a particular built-in mode over AUCTeX mode, remove it
+     from this list.  Type
+          M-x customize-option <RET> TeX-modes <RET>
+     to manipulate the contents of ‘TeX-modes’.
+
+   Don't remove ‘tex-mode’ from ‘TeX-modes’ because it results in
+inconsistent behavior.
+
+   On Emacs 29 and later, you can alter ‘major-mode-remap-alist’ instead
+of ‘TeX-modes’ as you like to arrange AUCTeX redirections.  In fact,
+‘TeX-modes’ option does nothing other than setting up
+‘major-mode-remap-alist’ according its value on those Emacsens.
 
    If you want to remove a preinstalled AUCTeX completely before any of
 its modes have been used,
      (unload-feature 'tex-site)
-should accomplish that.
+in your init file should accomplish that.
 
 
 File: auctex.info,  Node: Advice for package providers,  Next: Advice for 
non-privileged users,  Prev: Loading the package,  Up: Installation
@@ -6247,8 +6265,8 @@ A.1 Copying this Manual
 
 The copyright notice for this manual is:
 
-   This manual is for AUCTeX (version 14.0.2 from 2024-02-09), a
-sophisticated TeX environment for Emacs.
+   This manual is for AUCTeX (version 14.0.2.2024-02-20 from
+2024-02-20), a sophisticated TeX environment for Emacs.
 
    Copyright © 1992-1995, 2001, 2002, 2004-2024 Free Software
 Foundation, Inc.
@@ -8513,6 +8531,10 @@ A.4 Frequently Asked Questions
 
   1. Something is not working correctly.  What should I do?
 
+     If you are having trouble with upgrading ELPA package, first have a
+     look at the dedicated entry below.  If that doesn't resolve your
+     issue, then come back here and proceed.
+
      Well, you might have guessed it, the first place to look is in the
      available documentation packaged with AUCTeX.  This could be the
      release notes (in the ‘RELEASE’ file) or the news section of the
@@ -8561,12 +8583,46 @@ A.4 Frequently Asked Questions
      you have to search either in the site configuration file or your
      personal init file for statements related to the problem.
 
-  2. What versions of Emacs are supported?
+  2. ELPA upgrade fails.  What should I do?
+
+     In general, ELPA upgrade can fail in a Emacs session you are
+     running, especially when AUCTeX major version increases.  This
+     entry covers the following cases in such casual upgrade.
+        • Upgrade stops with error and doesn't complete.
+        • Upgrade falls in infinite loop and doesn't terminate.  You
+          have to interrupt it with ‘C-g’ and upgrade doesn't complete.
+        • It looks like upgrade finishes successfully but afterwards
+          AUCTeX breaks with mysterious error like:
+               TeX-command-expand: Wrong type argument: stringp, nil
+
+     These issues involve byte compilation failure.  In the third case,
+     the generated ‘.elc’ files are actually corrupted.  Thus the point
+     is to have sane byte compilation.
+
+     The first thing which is worth trying is:
+       1. Terminate the current running Emacs session and restart Emacs.
+       2. Type ‘M-x package-recompile <RET> auctex <RET>’.
+       3. Restart your Emacs again.
+
+     If you are lucky enough, this will basically resolve the issue.
+     There is still old ‘auctex-X.Y.Z’ directory left behind under
+     ‘~/.emacs.d/elpa/’, so delete it manually to avoid future trouble.
+
+     If the above prescription doesn't work, then try:
+       1. Uninstall AUCTeX once.
+       2. Restart your Emacs and (before doing anything else) reinstall
+          AUCTeX.
+
+     In theory, this recipe will circumvent all caveats in ELPA upgrade
+     of AUCTeX.  Find and delete old ‘auctex-X.Y.Z’ directory remaining
+     under ‘~/.emacs.d/elpa/’.
+
+  3. What versions of Emacs are supported?
 
      AUCTeX was tested with GNU Emacs 27.1.  Older versions may work but
      are unsupported.
 
-  3. What should I do when ‘./configure’ does not find programs like
+  4. What should I do when ‘./configure’ does not find programs like
      ‘latex’?
 
      This is problem often encountered on Windows.  Make sure that the
@@ -8574,7 +8630,7 @@ A.4 Frequently Asked Questions
      relevant programs, as described in *note (auctex)Installation under
      MS Windows::.
 
-  4. Why doesn't the completion, style file, or multifile stuff work?
+  5. Why doesn't the completion, style file, or multifile stuff work?
 
      It must be enabled first, insert this in your init file:
 
@@ -8585,18 +8641,18 @@ A.4 Frequently Asked Questions
      Read also the chapters about parsing and multifile documents in the
      manual.  *Note Parsing Files:: and *note Multifile::.
 
-  5. Why doesn't ‘TeX-save-document’ work?
+  6. Why doesn't ‘TeX-save-document’ work?
 
      ‘TeX-check-path’ has to contain "‘./’" somewhere.
 
-  6. Why is the information in ‘foo.tex’ forgotten when I save
+  7. Why is the information in ‘foo.tex’ forgotten when I save
      ‘foo.bib’?
 
      For various reasons, AUCTeX ignores the extension when it stores
      information about a file, so you should use unique base names for
      your files.  E.g. rename ‘foo.bib’ to ‘foob.bib’.
 
-  7. Why doesn't AUCTeX signal when processing a document is done?
+  8. Why doesn't AUCTeX signal when processing a document is done?
 
      If the message in the minibuffer stays "Type 'C-c C-l' to display
      results of compilation.", you probably have a misconfiguration in
@@ -8608,7 +8664,7 @@ A.4 Frequently Asked Questions
      The information in the debugging buffer can help you find the cause
      of the error in your init file.
 
-  8. Why does ‘TeX-next-error’ (‘C-c `’) fail?
+  9. Why does ‘TeX-next-error’ (‘C-c `’) fail?
 
      If ‘TeX-file-line-error’ is set to ‘nil’ (not the default), these
      sort of failures might be related to the the fact that when writing
@@ -8625,7 +8681,7 @@ A.4 Frequently Asked Questions
      manual to see where this is) or by simply keeping the variable
      ‘TeX-file-line-error’ to the default value of non-‘nil’.
 
-  9. What does ‘AUC’ stand for?
+  10. What does ‘AUC’ stand for?
 
      AUCTeX came into being at Aalborg University in Denmark.  Back then
      the Danish name of the university was Aalborg Universitetscenter;
@@ -9460,6 +9516,7 @@ Variable Index
 * TeX-master <2>:                        Multifile.           (line  39)
 * TeX-math-input-method-off-regexp:      Mathematics.         (line  76)
 * TeX-mode-hook:                         Modes and Hooks.     (line  22)
+* TeX-modes:                             Loading the package. (line  40)
 * TeX-newline-function:                  Indenting.           (line  29)
 * TeX-newline-function <1>:              Indenting.           (line 107)
 * TeX-Omega-command:                     Processor Options.   (line 121)
@@ -9913,105 +9970,105 @@ Concept Index
 
 
 Tag Table:
-Node: Top916
-Node: Copying7384
-Node: Introduction9333
-Node: Summary9603
-Node: Installation12340
-Node: Prerequisites14349
-Node: Configure16570
-Node: Build/install and uninstall21305
-Node: Loading the package22062
-Node: Advice for package providers23799
-Node: Advice for non-privileged users26668
-Node: Installation under MS Windows32166
-Node: Customizing46052
-Node: Quick Start47657
-Ref: Quick Start-Footnote-149790
-Node: Editing Facilities49892
-Node: Processing Facilities54773
-Node: Editing59654
-Node: Quotes60992
-Node: Font Specifiers70556
-Node: Sectioning72764
-Node: Environments77495
-Node: Equations83183
-Node: Floats83803
-Node: Itemize-like85839
-Node: Tabular-like86703
-Node: Customizing Environments88593
-Node: Mathematics88833
-Node: Completion92375
-Node: Marking100696
-Node: Marking (LaTeX)101332
-Node: Marking (Texinfo)102288
-Node: Commenting103937
-Node: Indenting105322
-Node: Filling114047
-Node: Display120065
-Node: Font Locking122576
-Node: Fontification of macros124675
-Node: Fontification of quotes134682
-Node: Fontification of math136226
-Node: Verbatim content140007
-Node: Faces140797
-Node: Known problems141302
-Node: Folding142311
-Node: Outline153460
-Node: Narrowing154783
-Node: Prettifying155860
-Node: Processing157147
-Node: Commands158507
-Node: Starting a Command159071
-Node: Selecting a Command164227
-Node: Processor Options173638
-Node: Viewing184914
-Node: Starting Viewers185288
-Node: I/O Correlation191098
-Ref: I/O Correlation-Footnote-1196854
-Node: Debugging197116
-Node: Ignoring warnings199818
-Node: Error overview201937
-Node: Checking203879
-Node: Control205567
-Node: Cleaning207718
-Node: Documentation209171
-Node: Customization210292
-Node: Modes and Hooks210785
-Node: Multifile212934
-Node: Parsing Files217778
-Node: Internationalization222815
-Node: European224168
-Node: Japanese232117
-Node: Automatic237390
-Node: Automatic Global239929
-Node: Automatic Private241071
-Node: Automatic Local242435
-Node: Style Files243709
-Node: Simple Style244523
-Node: Adding Macros248316
-Node: Adding Environments258133
-Node: Adding Other263595
-Node: Hacking the Parser268281
-Node: Appendices272293
-Node: Copying this Manual272589
-Node: GNU Free Documentation License273471
-Node: Changes298594
-Node: Development365681
-Node: Mid-term Goals366327
-Node: Wishlist369222
-Node: Bugs375411
-Node: FAQ376547
-Node: Texinfo mode382421
-Node: Exploiting383555
-Node: Superseding384377
-Node: Mapping389192
-Node: Unbinding391135
-Node: Indices391683
-Node: Key Index391846
-Node: Function Index399740
-Node: Variable Index412302
-Node: Concept Index438026
+Node: Top927
+Node: Copying7395
+Node: Introduction9344
+Node: Summary9614
+Node: Installation12351
+Node: Prerequisites14360
+Node: Configure16581
+Node: Build/install and uninstall21316
+Node: Loading the package22073
+Node: Advice for package providers24737
+Node: Advice for non-privileged users27606
+Node: Installation under MS Windows33104
+Node: Customizing46990
+Node: Quick Start48595
+Ref: Quick Start-Footnote-150728
+Node: Editing Facilities50830
+Node: Processing Facilities55711
+Node: Editing60592
+Node: Quotes61930
+Node: Font Specifiers71494
+Node: Sectioning73702
+Node: Environments78433
+Node: Equations84121
+Node: Floats84741
+Node: Itemize-like86777
+Node: Tabular-like87641
+Node: Customizing Environments89531
+Node: Mathematics89771
+Node: Completion93313
+Node: Marking101634
+Node: Marking (LaTeX)102270
+Node: Marking (Texinfo)103226
+Node: Commenting104875
+Node: Indenting106260
+Node: Filling114985
+Node: Display121003
+Node: Font Locking123514
+Node: Fontification of macros125613
+Node: Fontification of quotes135620
+Node: Fontification of math137164
+Node: Verbatim content140945
+Node: Faces141735
+Node: Known problems142240
+Node: Folding143249
+Node: Outline154398
+Node: Narrowing155721
+Node: Prettifying156798
+Node: Processing158085
+Node: Commands159445
+Node: Starting a Command160009
+Node: Selecting a Command165165
+Node: Processor Options174576
+Node: Viewing185852
+Node: Starting Viewers186226
+Node: I/O Correlation192036
+Ref: I/O Correlation-Footnote-1197792
+Node: Debugging198054
+Node: Ignoring warnings200756
+Node: Error overview202875
+Node: Checking204817
+Node: Control206505
+Node: Cleaning208656
+Node: Documentation210109
+Node: Customization211230
+Node: Modes and Hooks211723
+Node: Multifile213872
+Node: Parsing Files218716
+Node: Internationalization223753
+Node: European225106
+Node: Japanese233055
+Node: Automatic238328
+Node: Automatic Global240867
+Node: Automatic Private242009
+Node: Automatic Local243373
+Node: Style Files244647
+Node: Simple Style245461
+Node: Adding Macros249254
+Node: Adding Environments259071
+Node: Adding Other264533
+Node: Hacking the Parser269219
+Node: Appendices273231
+Node: Copying this Manual273527
+Node: GNU Free Documentation License274420
+Node: Changes299543
+Node: Development366630
+Node: Mid-term Goals367276
+Node: Wishlist370171
+Node: Bugs376360
+Node: FAQ377496
+Node: Texinfo mode385188
+Node: Exploiting386322
+Node: Superseding387144
+Node: Mapping391959
+Node: Unbinding393902
+Node: Indices394450
+Node: Key Index394613
+Node: Function Index402507
+Node: Variable Index415069
+Node: Concept Index440866
 
 End Tag Table
 
diff --git a/preview-latex.info b/preview-latex.info
index 0cbe1cb5..89eef290 100644
--- a/preview-latex.info
+++ b/preview-latex.info
@@ -2,7 +2,7 @@ This is preview-latex.info, produced by makeinfo version 7.1 
from
 preview-latex.texi.
 
 This manual is for preview-latex, a LaTeX preview mode for AUCTeX
-(version 14.0.2 from 2024-02-09).
+(version 14.0.2.2024-02-20 from 2024-02-20).
 
    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 14.0.2 from 2024-02-09).
+(version 14.0.2.2024-02-20 from 2024-02-20).
 
    Copyright © 2001, 2002, 2003, 2004, 2005, 2006, 2017-2019, 2021 Free
 Software Foundation, Inc.
@@ -2550,44 +2550,44 @@ Index
 
 
 Tag Table:
-Node: Top958
-Node: Copying2238
-Node: Introduction2692
-Node: What use is it?3366
-Node: Activating preview-latex4759
-Node: Getting started5514
-Node: Basic modes of operation7497
-Node: More documentation8726
-Node: Availability9615
-Node: Contacts10342
-Node: Installation11623
-Node: Keys and lisp11824
-Node: Simple customization19095
-Node: Known problems24915
-Node: Font problems with Dvips25801
-Node: Too small bounding boxes27007
-Node: x-symbol interoperation28427
-Node: Middle-clicks paste instead of toggling29847
-Node: No images are displayed with gs 9.27 and earlier30544
-Node: Black texts are too hard to read on dark background33290
-Node: For advanced users33943
-Node: The LaTeX style file34402
-Node: Package options36980
-Node: Provided commands48188
-Node: The Emacs interface55789
-Node: The preview images64731
-Node: Misplaced previews68612
-Node: ToDo72136
-Node: Frequently Asked Questions76965
-Node: Introduction to FAQ77288
-Node: Requirements77627
-Node: Installation Trouble79611
-Node: Customization81903
-Node: Troubleshooting85027
-Node: Other formats87541
-Node: Copying this Manual88888
-Node: GNU Free Documentation License89833
-Node: Index114959
+Node: Top969
+Node: Copying2249
+Node: Introduction2703
+Node: What use is it?3377
+Node: Activating preview-latex4770
+Node: Getting started5525
+Node: Basic modes of operation7508
+Node: More documentation8737
+Node: Availability9626
+Node: Contacts10353
+Node: Installation11634
+Node: Keys and lisp11835
+Node: Simple customization19106
+Node: Known problems24926
+Node: Font problems with Dvips25812
+Node: Too small bounding boxes27018
+Node: x-symbol interoperation28438
+Node: Middle-clicks paste instead of toggling29858
+Node: No images are displayed with gs 9.27 and earlier30555
+Node: Black texts are too hard to read on dark background33301
+Node: For advanced users33954
+Node: The LaTeX style file34413
+Node: Package options36991
+Node: Provided commands48199
+Node: The Emacs interface55800
+Node: The preview images64742
+Node: Misplaced previews68623
+Node: ToDo72147
+Node: Frequently Asked Questions76976
+Node: Introduction to FAQ77299
+Node: Requirements77638
+Node: Installation Trouble79622
+Node: Customization81914
+Node: Troubleshooting85038
+Node: Other formats87552
+Node: Copying this Manual88899
+Node: GNU Free Documentation License89855
+Node: Index114981
 
 End Tag Table
 
diff --git a/tex-site.el b/tex-site.el
index 8aa272b5..fda45b01 100644
--- a/tex-site.el
+++ b/tex-site.el
@@ -168,11 +168,11 @@ Otherwise, restore AUCTeX definition saved in the symbol 
property
   (if (featurep 'tex-site)
       (TeX--alias-overlapped-modes t)))
 
-(defconst AUCTeX-version "14.0.2"
+(defconst AUCTeX-version "14.0.2.2024-02-20"
   "AUCTeX version.
 If not a regular release, the date of the last change.")
 
-(defconst AUCTeX-date "2024-02-09"
+(defconst AUCTeX-date "2024-02-20"
   "AUCTeX release date using the ISO 8601 format, yyyy-mm-dd.")
 
 ;; Store bibitems when saving a BibTeX buffer