Subject: RE: bug#44202: [PATCH] Add variable to control confirmation of help-mode-revert-buffer

From: Drew Adams <[email-masked]>
Date: Sat, 24 Oct 2020 16:40:39 -0700 (PDT)

> +(defcustom help-mode-revert-buffer-noconfirm nil
> +  "Indicates whether to prompt for confirmation when reverting a
> +help buffer."

A minor comment (and others may disagree with me).

I think the first line of the doc string should
say what a true value means, because the option
name does that.

Or at least the doc string should somehow make
clear which Boolean value means which behavior.

E.g.:

Non-nil means do not prompt for confirmation when reverting a help buffer.

If you just say "whether" there's no way to know
which value means what, except to guess from the
option name, in which case the doc string doesn't
add anything.