From: Yuan Fu <casouri@gmail.com>
Date: Sat, 21 Dec 2024 06:46:31 +0000 (-0800)
Subject: ; Minor comment improvement in c-ts-common--adaptive-fill-prefix
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=624ce9389ffc9fc91f10e92fb9bdde132e8e65ca;p=emacs.git

; Minor comment improvement in c-ts-common--adaptive-fill-prefix

* lisp/progmodes/c-ts-common.el (c-ts-common--adaptive-fill-prefix):
Improve comment.

(cherry picked from commit 8d7cba7bbf8fe83bbf9a9d8cae963983f3bca8cf)
---

diff --git a/lisp/progmodes/c-ts-common.el b/lisp/progmodes/c-ts-common.el
index 363a0b42292..2d7607987c2 100644
--- a/lisp/progmodes/c-ts-common.el
+++ b/lisp/progmodes/c-ts-common.el
@@ -249,9 +249,12 @@ This function should be called at BOL.  Used by
    ;; (3)
    ;; Current line: *, |, -
    ;; Prefix: same.
-   ;; This branch must return the same prefix as branch (1), as the
-   ;; second line in the paragraph; then the whole paragraph will use *
-   ;; as the prefix.
+   ;; Adaptive fill looks at the first and second line of a paragraph,
+   ;; only when both lines return the same prefix does it use that
+   ;; prefix for the following lines.  If the first lines matches branch
+   ;; (1) and returns * as prefix, and the second line matches this
+   ;; branch (3), and returns * as prefix, then the whole paragraph will
+   ;; use * as prefix.
    ((looking-at (rx (* (syntax whitespace))
                     (or "*" "|" "-")
                     (* (syntax whitespace))))