From 000fe859c2e68391d2dd772c961f6862b50d1069 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) (cherry picked from commit 44a770b87137c93f0c4af4d203bb071659a603a0) --- 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 7a2ef9be16e..08add98b733 100644 --- a/doc/emacs/rmail.texi +++ b/doc/emacs/rmail.texi @@ -1535,7 +1535,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 0d657aea8a1..41b0813707f 100644 --- a/lisp/mail/rmail.el +++ b/lisp/mail/rmail.el @@ -176,7 +176,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)) -- 2.39.5