From: Eli Zaretskii <eliz@gnu.org>
Date: Fri, 14 Jun 2024 18:42:18 +0000 (+0300)
Subject: ; Update comments in a recent commit
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=d160728de6150083a6fe736132df64435b100d7a;p=emacs.git

; 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 d89257f23be..3dc1dc266ad 100644
--- 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 80e692ba2af..a10b7d3b7c8 100644
--- 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 58d9f8162df..0167ceff7e0 100644
--- 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