; Improve documentation of 'rmail-movemail-program'

* lisp/mail/rmail.el (rmail-movemail-program):
* doc/emacs/rmail.texi (Movemail): Document how to change the
value of 'rmail-movemail-program' safely.  (Bug#76595)
This commit is contained in:
Eli Zaretskii 2025-03-01 15:45:57 +02:00
parent 3998dea566
commit 44a770b871
2 changed files with 8 additions and 2 deletions

View file

@ -1527,7 +1527,10 @@ This is equivalent to specifying the @samp{file} protocol:
absolute file name of the @command{movemail} executable. If it is absolute file name of the @command{movemail} executable. If it is
@code{nil}, Rmail searches for @command{movemail} in the directories @code{nil}, Rmail searches for @command{movemail} in the directories
listed in @code{rmail-movemail-search-path}, then in @code{exec-path} listed in @code{rmail-movemail-search-path}, then in @code{exec-path}
(@pxref{Shell}), then in @code{exec-directory}. (@pxref{Shell}), then in @code{exec-directory}. This variable should be
customized before starting Rmail; if you customize it after starting
Rmail, you will need to set @code{rmail-movemail-variant-in-use} to the
@code{nil} value, and then restart Rmail.
@node Remote Mailboxes @node Remote Mailboxes
@section Retrieving Mail from Remote Mailboxes @section Retrieving Mail from Remote Mailboxes

View file

@ -177,7 +177,10 @@ Its name should end with a slash."
:group 'rmail) :group 'rmail)
(defcustom rmail-movemail-program nil (defcustom rmail-movemail-program nil
"If non-nil, the file name of the `movemail' program." "If non-nil, the file name of the `movemail' program.
If you customize this after starting Rmail, reset the
variable `rmail-movemail-variant-in-use' to the nil value,
and then restart Rmail."
:group 'rmail-retrieve :group 'rmail-retrieve
:type '(choice (const nil) string)) :type '(choice (const nil) string))