[elpa] externals/auctex 94127f5e10 37/43: Make banner regexp customizable

[Tassilo Horn]

branch: externals/auctex
commit 94127f5e10e071f3245d0206d7fd5d5966101ac3
Author: Ikumi Keita <ikumi@ikumi.que.jp>
Commit: Ikumi Keita <ikumi@ikumi.que.jp>

    Make banner regexp customizable
    
    * tex.el (TeX-LaTeX-sentinel-banner-regexp): Turn the regexp to
    identify the banner line in the LaTeX output into customize option.
    (TeX-LaTeX-sentinel): Use it.
    * doc/auctex.texi (Processor Options): Mention the new option.
    (): Update copyright year.
---
 doc/auctex.texi | 16 +++++++++++++++-
 tex.el          | 10 ++++++++--
 2 files changed, 23 insertions(+), 3 deletions(-)

diff --git a/doc/auctex.texi b/doc/auctex.texi
index c4cd025761..9983d9d702 100644
--- a/doc/auctex.texi
+++ b/doc/auctex.texi
@@ -12,7 +12,7 @@ This manual is for @AUCTeX{}
 (version @value{VERSION} from @value{UPDATED}),
 a sophisticated @TeX{} environment for Emacs.
 
-Copyright @copyright{} 1992-1995, 2001, 2002, 2004-2023
+Copyright @copyright{} 1992-1995, 2001, 2002, 2004-2024
 Free Software Foundation, Inc.
 
 @quotation
@@ -3521,6 +3521,20 @@ a command not found error.  The error code returned by 
the shell in this
 case can be set in @code{TeX-check-TeX-command-not-found} option.
 @end defopt
 
+In addtion, @AUCTeX{} searches for a line similar to
+@example
+LaTeX2e <2022-11-01> patch level 1
+@end example
+in the console log to check whether @command{latex} command runs
+successfully.  If there isn't such a line when running @LaTeX{}, @AUCTeX{}
+warns the problem and resets the next default command to ``LaTeX''.  If
+this check doesn't suit for your use case, you can customize the
+@code{TeX-LaTeX-sentinel-banner-regexp} option:
+@defopt TeX-LaTeX-sentinel-banner-regexp
+When a @LaTeX{} run outputs a banner line matching this regexp, @AUCTeX{}
+considers that it was successfull.
+@end defopt
+
 Some @LaTeX{} packages requires the document to be compiled with a
 specific engine.  Notable examples are @samp{fontspec} and @samp{polyglossia}
 packages, which require Lua@TeX{} and Xe@TeX{} engines.  If you try to
diff --git a/tex.el b/tex.el
index 4768651826..3132472e17 100644
--- a/tex.el
+++ b/tex.el
@@ -709,6 +709,13 @@ commands."
   :group 'TeX-command
   :type 'boolean)
 
+(defcustom TeX-LaTeX-sentinel-banner-regexp
+  "^\\(\\*\\* \\)?J?I?p?\\(La\\|Sli\\)TeX\\(2e\\)? \
+\\(Version\\|ver\\.\\|<[0-9/-]*\\(?:u[^>]*\\)?>\\)"
+  "Regexp to identify the banner line in the LaTeX output."
+  :group 'TeX-output
+  :type 'regexp)
+
 ;;; Portability.
 
 (defmacro TeX--if-macro-fboundp (name then &rest else)
@@ -8531,8 +8538,7 @@ Changebar info has changed." nil t)
           "%s" "You should run LaTeX again to synchronize exercise properties")
          (setq TeX-command-next TeX-command-default))
         ((re-search-forward
-          "^\\(\\*\\* \\)?J?I?p?\\(La\\|Sli\\)TeX\\(2e\\)? \
-\\(Version\\|ver\\.\\|<[0-9/-]*\\(?:u[^>]*\\)?>\\)" nil t)
+          TeX-LaTeX-sentinel-banner-regexp nil t)
          (let* ((warnings (and TeX-debug-warnings
                                (TeX-LaTeX-sentinel-has-warnings)))
                 (bad-boxes (and TeX-debug-bad-boxes