# HG changeset patch
# User Luc Teirlinck <teirllm@auburn.edu>
# Date 1075523912 0
# Node ID bf9aef2a393df884960d623821488dee47102bc4
# Parent  0505a2aecd0a46d31a5ab99efbdf37a16f59f85e
(read-directory-name): Adapt the docstring to recent change in Fread_file_name.

diff -r 0505a2aecd0a -r bf9aef2a393d lisp/files.el
--- 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