master 90d2813f42: Clarify message-newline-and-reformat doc string

[Lars Ingebrigtsen]

branch: master
commit 90d2813f42678bbb5d22fbb6f59523ba567c6f36
Author: Lars Ingebrigtsen <larsi@gnus.org>
Commit: Lars Ingebrigtsen <larsi@gnus.org>

    Clarify message-newline-and-reformat doc string
    
    * lisp/gnus/message.el (message-newline-and-reformat): Clarify the
    DWIM-ness in the doc string (bug#57986).
---
 lisp/gnus/message.el | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/lisp/gnus/message.el b/lisp/gnus/message.el
index 49a04f601f..e19ac76869 100644
--- a/lisp/gnus/message.el
+++ b/lisp/gnus/message.el
@@ -3551,7 +3551,12 @@ of lines before the signature intact."
 
 (defun message-newline-and-reformat (&optional arg not-break)
   "Insert four newlines, and then reformat if inside quoted text.
-Prefix arg means justify as well."
+Prefix arg means justify as well.
+
+This function tries to guess what the quote prefix is based on
+the text on the current line before point.  If point is at the
+start of the line, the formatted text (if any) is filled without
+a quote prefix."
   (interactive (list (if current-prefix-arg 'full)) message-mode)
   (unless (message-in-body-p)
     (error "This command only works in the body of the message"))