bug#74773: [PATCH] Elaborate doc string for rcirc-next-active-buffer

[Eli Zaretskii <eliz@gnu.org>]

> Date: Tue, 10 Dec 2024 12:20:04 -0700
> From:  Scott Bell via "Bug reports for GNU Emacs,
>  the Swiss army knife of text editors" <bug-gnu-emacs@gnu.org>
> 
> I found the current behavior of rcirc-next-active-buffer surprising in
> the case where there is no activity, so I thought it could be described
> in the doc string.

Leo and Philip, is this okay to install?

> >From b5a3f93c006316d53139bbd308afbf4c70c89289 Mon Sep 17 00:00:00 2001
> From: Scott Bell <sctb@me.com>
> Date: Tue, 10 Dec 2024 12:02:54 -0700
> Subject: [PATCH] ; * lisp/net/rcirc.el (rcirc-next-active-buffer): Doc string
> 
> ---
>  lisp/net/rcirc.el | 3 ++-
>  1 file changed, 2 insertions(+), 1 deletion(-)
> 
> diff --git a/lisp/net/rcirc.el b/lisp/net/rcirc.el
> index c41e2ec153f..33e4008fc0b 100644
> --- a/lisp/net/rcirc.el
> +++ b/lisp/net/rcirc.el
> @@ -2448,7 +2448,8 @@ rcirc-bury-buffers
>  
>  (defun rcirc-next-active-buffer (arg)
>    "Switch to the next rcirc buffer with activity.
> -With prefix ARG, go to the next low priority buffer with activity."
> +With prefix ARG, go to the next low priority buffer with activity.
> +When there are no buffers with activity, bury all rcirc buffers."
>    (interactive "P")
>    (let* ((pair (rcirc-split-activity rcirc-activity))
>           (lopri (car pair))
> -- 
> 2.39.5 (Apple Git-154)
>