bug#53810: 29.0.50; Incorrect docstring for ietf-drums-get-comment

bug#53810: 29.0.50; Incorrect docstring for ietf-drums-get-comment

[Bob Rogers]

In GNU Emacs 29.0.50 (build 2, x86_64-pc-linux-gnu, GTK+ Version 3.24.20, cairo version 1.16.0)
 of 2022-02-02 built on orion
Repository revision: ed13b0d0f427df333f8e1f9a24015c354da4c62f
Repository branch: rgr-ietf-drums-date
Windowing system distributor 'The X.Org Foundation', version 11.0.12003000
System Description: openSUSE Leap 15.3

   In master as of d34dd869d2, doing

	(ietf-drums-get-comment "random (comment) (string)")

returns "string", whereas the docstring says it returns the content of
the first comment.  The documentation for both ietf-drums-get-comment
and mail-header-get-comment say "last"; perusing the code (only
ietf-drums-get-comment is actually called) also shows that the last one
is what callers expect.

					-- Bob Rogers
					   http://www.rgrjr.com/

From d1c9098ddfe0a913f8c20606347e334ca06dd9d3 Mon Sep 17 00:00:00 2001
From: Bob Rogers <rogers@rgrjr.com>
Date: Sat, 5 Feb 2022 18:27:58 -0500
Subject: [PATCH] ; Correct the ietf-drums-get-comment docstring

* lisp/mail/ietf-drums.el (ietf-drums-get-comment):  We really return
  the last comment.
---
 lisp/mail/ietf-drums.el | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lisp/mail/ietf-drums.el b/lisp/mail/ietf-drums.el
index 952707226f..fd9cb6abb7 100644
--- a/lisp/mail/ietf-drums.el
+++ b/lisp/mail/ietf-drums.el
@@ -150,7 +150,7 @@ ietf-drums-remove-whitespace
       (buffer-string))))
 
 (defun ietf-drums-get-comment (string)
-  "Return the first comment in STRING."
+  "Return the last comment in STRING."
   (with-temp-buffer
     (ietf-drums-init string)
     (let (result c)
-- 
2.34.1

bug#53810: 29.0.50; Incorrect docstring for ietf-drums-get-comment

[Lars Ingebrigtsen]

Bob Rogers <rogers@rgrjr.com> writes:

> * lisp/mail/ietf-drums.el (ietf-drums-get-comment):  We really return
>   the last comment.

Thanks; pushed to emacs-28.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no