Mercurial > emacs
changeset 53765:bf9aef2a393d
(read-directory-name): Adapt the docstring to recent change in Fread_file_name.
author | Luc Teirlinck <teirllm@auburn.edu> |
---|---|
date | Sat, 31 Jan 2004 04:38:32 +0000 |
parents | 0505a2aecd0a |
children | ec7e8552309c |
files | lisp/files.el |
diffstat | 1 files changed, 7 insertions(+), 2 deletions(-) [+] |
line wrap: on
line diff
--- a/lisp/files.el Sat Jan 31 04:24:23 2004 +0000 +++ b/lisp/files.el Sat Jan 31 04:38:32 2004 +0000 @@ -490,13 +490,18 @@ (defun read-directory-name (prompt &optional dir default-dirname mustmatch initial) "Read directory name, prompting with PROMPT and completing in directory DIR. Value is not expanded---you must call `expand-file-name' yourself. -Default name to DEFAULT-DIRNAME if user enters a null string. +Default name to DEFAULT-DIRNAME if user exits with the same +non-empty string that was inserted by this function. (If DEFAULT-DIRNAME is omitted, the current buffer's directory is used, except that if INITIAL is specified, that combined with DIR is used.) +If the user exits with an empty minibuffer, this function returns +an empty string. (This can only happen if the user erased the +pre-inserted contents or if `insert-default-directory' is nil.) Fourth arg MUSTMATCH non-nil means require existing directory's name. Non-nil and non-t means also require confirmation after completion. Fifth arg INITIAL specifies text to start with. -DIR defaults to current buffer's directory default." +DIR should be an absolute directory name. It defaults to +the value of `default-directory'." (unless dir (setq dir default-directory)) (unless default-dirname