[AUCTeX-diffs] GNU AUCTeX branch, master, updated. e37c7a8b392d72f242f9fbc9ebb6e8ac74af41b7

[Ikumi Keita]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU AUCTeX".

The branch, master has been updated
       via  e37c7a8b392d72f242f9fbc9ebb6e8ac74af41b7 (commit)
      from  2b11084455cfc2e8106f8e63201a6400e3c14124 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit e37c7a8b392d72f242f9fbc9ebb6e8ac74af41b7
Author: Ikumi Keita <ikumi@ikumi.que.jp>
Date:   Wed Mar 16 18:56:42 2022 +0900

    Revise documentation about simultaneous process
    
    * doc/auctex.texi (Starting a Command):
    * tex-buf.el:
    State explicitly that AUCTeX doesn't support concurrent typesets.
    Update copyright year.

diff --git a/doc/auctex.texi b/doc/auctex.texi
index 8c46e587..c5339097 100644
--- a/doc/auctex.texi
+++ b/doc/auctex.texi
@@ -2974,14 +2974,17 @@ activated mark, however, will always define a new 
region when calling
 @code{TeX-command-region}.
 @end deffn
 
-@AUCTeX{} will allow one process for each document, plus one process
-for the region file to be active at the same time.  Thus, if you are
-editing @var{n} different documents, you can have @var{n} plus one
-processes running at the same time.  If the last process you started was
+If the last process you started was
 on the region, the commands described in @ref{Debugging} and
 @ref{Control} will work on that process, otherwise they will work on the
 process associated with the current document.
 
+Don't run more than one process at the same time.  @AUCTeX{} doesn't
+support simultaneous typeset including region typeset.  Wait for the
+previous process to finish before you start a new process, in particular
+when you are editing multiple documents in parallel.  This limitation
+applies for preview by @previewlatex{} as well.
+
 @node Selecting a Command
 @subsection Selecting and Executing a Command
 
diff --git a/tex-buf.el b/tex-buf.el
index bc363a1d..a3892d3f 100644
--- a/tex-buf.el
+++ b/tex-buf.el
@@ -1,6 +1,6 @@
 ;;; tex-buf.el --- External commands for AUCTeX.  -*- lexical-binding: t; -*-
 
-;; Copyright (C) 1991-2021  Free Software Foundation, Inc.
+;; Copyright (C) 1991-2022  Free Software Foundation, Inc.
 
 ;; Maintainer: auctex-devel@gnu.org
 ;; Keywords: tex, wp
@@ -59,16 +59,16 @@
 ;;; Interactive Commands
 ;;
 ;; The general idea is, that there is one process and process buffer
-;; associated with each master file, and one process and process buffer
-;; for running TeX on a region.   Thus, if you have N master files, you
-;; can run N + 1 processes simultaneously.
+;; associated with each master file, and one process and process
+;; buffer for running TeX on a region.
 ;;
-;; Some user commands operates on ``the'' process.  The following
-;; algorithm determine what ``the'' process is.
-;;
-;; IF   last process started was on a region
-;; THEN ``the'' process is the region process
-;; ELSE ``the'' process is the master file (of the current buffer) process
+;; Some user commands operates on ``the'' process, which is the last
+;; process still running or already finished.  Note that you cannot
+;; run more than one process simultaneously, including preview by
+;; preview-latex, because process filters and sentinels refer to
+;; certain set of global variables which each invokation of the
+;; process overwrites.  If you dare to do, the result is thus
+;; unpredictable.
 
 (defun TeX-save-document (name-or-file-fn)
   "Save all files belonging to the current document.

-----------------------------------------------------------------------

Summary of changes:
 doc/auctex.texi | 11 +++++++----
 tex-buf.el      | 20 ++++++++++----------
 2 files changed, 17 insertions(+), 14 deletions(-)


hooks/post-receive
-- 
GNU AUCTeX