From d160728de6150083a6fe736132df64435b100d7a Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Fri, 14 Jun 2024 21:42:18 +0300 Subject: [PATCH] ; 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) --- src/coding.h | 5 +++-- src/insdel.c | 5 ++--- src/process.c | 1 + 3 files changed, 6 insertions(+), 5 deletions(-) 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 -- 2.39.2