GNU bug report logs - #8480
24.0.50; (elisp) Reading File Names

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 8480 in the body.
You can then email your comments to 8480 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <bug-gnu-emacs <at> gnu.org>
Subject: 24.0.50; (elisp) Reading File Names
Date: Mon, 11 Apr 2011 15:42:56 -0700

Doc for `read-file-name': Just after describing the PREDICATE arg, we
say that `read-file-name' does not automatically expand file names etc.
 
Then we say "Here is an example:" and give an overall example of using
`read-file-name'.  This is not an example to show that `r-f-n' does not
automatically expand file names.  In fact, this example might be misread
as trying to show the opposite, since the result returned is an absolute
file name.
 
If the example here, as I suppose, is supposed to be general, then it
should be introduced as such, to avoid giving the impression that it is
meant to illustrate something about non-expansion of candidate names
(the topic just discussed).
 
A better example perhaps would show what happens when `insert-directory'
is nil or someone has deleted the directory portion.  Such an example
would also show that there is no automatic expansion of the result.
 
Finally, I think it should be pointed out that it is not only the result
returned by the function that does not get expanded.  If a user passes a
PREDICATE arg, s?he needs to know that the file name operated on by the
predicate has no directory component; i.e., no expansion is done here
either.
 
What's more, `default-directory' is not sufficient, in general, for the
proper relevant expansion.  Typically, to get the right directory for
expansion before testing by PREDICATE (if the directory is important for
the test), one needs to get it from the minibuffer (if it is there) or
somehow know it otherwise.
 

In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600)
 of 2011-04-11 on 3249CTO
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.5) --no-opt --cflags
-Ic:/imagesupport/include'
 

Message #8 received at 8480 <at> debbugs.gnu.org (full text, mbox):

From: Chong Yidong <cyd <at> stupidchicken.com>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 8480 <at> debbugs.gnu.org
Subject: Re: bug#8480: 24.0.50; (elisp) Reading File Names
Date: Sat, 28 May 2011 15:58:59 -0400

"Drew Adams" <drew.adams <at> oracle.com> writes:

> Doc for `read-file-name': Just after describing the PREDICATE arg, we
> say that `read-file-name' does not automatically expand file names
> etc.
>
> Then we say "Here is an example:" and give an overall example of using
> `read-file-name'.  This is not an example to show that `r-f-n' does not
> automatically expand file names.  In fact, this example might be misread
> as trying to show the opposite, since the result returned is an absolute
> file name.

OK, clarified.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.