; Update comments in a recent commit

* src/process.c (read_and_insert_process_output):
* src/insdel.c (insert_from_gap):
* src/coding.h (struct coding_system): Improve comments (bug#71525).

(cherry picked from commit 0372ce5f60c18956738a31985569b86444d52ec5)

diff --git a/src/coding.h b/src/coding.h
index d89257f23be73c0bd6fbcfaf49dccc5a8ce24dfa..3dc1dc266ad3875a22e142a3125d99a882a983ff 100644 (file)
--- a/src/coding.h
+++ b/src/coding.h
@@ -428,8 +428,9 @@ struct coding_system
   /* Set to true if charbuf contains an annotation.  */
   bool_bf annotated : 1;
 
-  /* True to insert before markers in the output buffer,
-     if `dst_object' is a buffer.  */
+  /* True if the decoded text should be inserted before markers in the
+     output buffer, if `dst_object' is a buffer.  Currently used only
+     when reading output from subprocesses.  */
   bool_bf insert_before_markers : 1;
 
   /* Used internally in coding.c.  See the comment of detect_ascii.  */

diff --git a/src/insdel.c b/src/insdel.c
index 80e692ba2af51b85580a80aa7851a94c1c85703f..a10b7d3b7c8d6a5c17e525b47e0eeba313565655 100644 (file)
--- a/src/insdel.c
+++ b/src/insdel.c
@@ -1131,9 +1131,8 @@ insert_from_gap_1 (ptrdiff_t nchars, ptrdiff_t nbytes, bool text_at_gap_tail)
    starting at GAP_END_ADDR - NBYTES (if text_at_gap_tail) and at
    GPT_ADDR (if not text_at_gap_tail).
 
-  If BEFORE_MARKERS is true, insert before markers.  At the moment the
-  only high-level callers of this functionality is
-  read_and_insert_process_output in process.c.  */
+  If BEFORE_MARKERS is true, insert before markers.  At the moment only
+  read_and_insert_process_output in process.c sets this to true.  */
 
 void
 insert_from_gap (ptrdiff_t nchars, ptrdiff_t nbytes, bool text_at_gap_tail,

diff --git a/src/process.c b/src/process.c
index 58d9f8162df5edd9858ba98feceaee519b6ae21c..0167ceff7e04a551dd636288e9277063a584b50a 100644 (file)
--- a/src/process.c
+++ b/src/process.c
@@ -6418,6 +6418,7 @@ read_and_insert_process_output (struct Lisp_Process *p, char *buf,
       specpdl_ref count1 = SPECPDL_INDEX ();
 
       XSETBUFFER (curbuf, current_buffer);
+      /* See the comment above about inserting before markers.  */
       process_coding->insert_before_markers = true;
       /* We cannot allow after-change-functions be run
         during decoding, because that might modify the