master fdc7272980: Improve the read-file-name doc string slightly

[Lars Ingebrigtsen]

branch: master
commit fdc72729802a60c64e44251b5a69824393ccd170
Author: Lars Ingebrigtsen <larsi@gnus.org>
Commit: Lars Ingebrigtsen <larsi@gnus.org>

    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 917879fb69..c9f5823940 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