[AUCTeX-diffs] [elpa] externals/auctex e37c7a8b39 31/60: Revise documentation about simultaneous process

[Tassilo Horn]

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

    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.
---
 doc/auctex.texi | 11 +++++++----
 tex-buf.el      | 20 ++++++++++----------
 2 files changed, 17 insertions(+), 14 deletions(-)

diff --git a/doc/auctex.texi b/doc/auctex.texi
index 8c46e5872f..c53390973f 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 bc363a1d36..a3892d3f0a 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.