emacs-28 2613677: * lisp/files.el (user-emacs-directory-warning): Clarify docstring.

[Stefan Kangas]

branch: emacs-28
commit 261367781b8f4dcbd58fff2f7a99cd8fb4581e65
Author: Stefan Kangas <stefan@marxist.se>
Commit: Stefan Kangas <stefan@marxist.se>

    * lisp/files.el (user-emacs-directory-warning): Clarify docstring.
---
 lisp/files.el | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/lisp/files.el b/lisp/files.el
index 2069074..32b7faa 100644
--- a/lisp/files.el
+++ b/lisp/files.el
@@ -1059,8 +1059,10 @@ the function needs to examine, starting with FILE."
     (if root (file-name-as-directory root))))
 
 (defcustom user-emacs-directory-warning t
-  "Non-nil means warn if cannot access `user-emacs-directory'.
-Set this to nil at your own risk..."
+  "Non-nil means warn if unable to access or create `user-emacs-directory'.
+Set this to nil at your own risk, as it might lead to data loss
+when Emacs tries to write something to a non-existent or
+inaccessible location."
   :type 'boolean
   :group 'initialization
   :version "24.4")