From fdc72729802a60c64e44251b5a69824393ccd170 Mon Sep 17 00:00:00 2001 From: Lars Ingebrigtsen Date: Fri, 28 Jan 2022 17:03:14 +0100 Subject: [PATCH] Improve the read-file-name doc string slightly * lisp/minibuffer.el (read-file-name): Note that the semantics of INITIAL are odd (bug#37883). --- lisp/minibuffer.el | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/lisp/minibuffer.el b/lisp/minibuffer.el index 917879fb692..c9f58239403 100644 --- a/lisp/minibuffer.el +++ b/lisp/minibuffer.el @@ -3066,7 +3066,10 @@ Fourth arg MUSTMATCH can take the following values: - anything else behaves like t except that typing RET does not exit if it does non-null completion. -Fifth arg INITIAL specifies text to start with. +Fifth arg INITIAL specifies text to start with. It will be +interpreted as the trailing part of DEFAULT-FILENAME, so using a +full file name for INITIAL will usually lead to surprising +results. Sixth arg PREDICATE, if non-nil, should be a function of one argument; then a file name is considered an acceptable completion -- 2.39.5