From 44a770b87137c93f0c4af4d203bb071659a603a0 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sat, 1 Mar 2025 15:45:57 +0200 Subject: [PATCH] ; 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) --- doc/emacs/rmail.texi | 5 ++++- lisp/mail/rmail.el | 5 ++++- 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/doc/emacs/rmail.texi b/doc/emacs/rmail.texi index 402386684ae..229dc6e3e33 100644 --- a/doc/emacs/rmail.texi +++ b/doc/emacs/rmail.texi @@ -1527,7 +1527,10 @@ This is equivalent to specifying the @samp{file} protocol: absolute file name of the @command{movemail} executable. If it is @code{nil}, Rmail searches for @command{movemail} in the directories 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 @section Retrieving Mail from Remote Mailboxes diff --git a/lisp/mail/rmail.el b/lisp/mail/rmail.el index c9c8b0f298e..41d177baf32 100644 --- a/lisp/mail/rmail.el +++ b/lisp/mail/rmail.el @@ -177,7 +177,10 @@ Its name should end with a slash." :group 'rmail) (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 :type '(choice (const nil) string))