GNU bug report logs - #15096
24.3.50; doc string of `read-file-name' - "value is not expanded"

Previous Next

Package: emacs;

Reported by: Drew Adams <drew.adams <at> oracle.com>

Date: Wed, 14 Aug 2013 21:44:01 UTC

Severity: minor

Found in version 24.3.50

Fixed in version 24.4

Done: Lars Ingebrigtsen <larsi <at> gnus.org>

Bug is archived. No further changes may be made.

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

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

View this report as an mbox folder, status mbox, maintainer mbox

Report forwarded to bug-gnu-emacs <at> gnu.org:
bug#15096; Package emacs. (Wed, 14 Aug 2013 21:44:01 GMT) Full text and rfc822 format available.
Acknowledgement sent to Drew Adams <drew.adams <at> oracle.com>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs <at> gnu.org. (Wed, 14 Aug 2013 21:44:02 GMT) Full text and rfc822 format available.

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.3.50; doc string of `read-file-name' - "value is not expanded"
Date: Wed, 14 Aug 2013 14:42:23 -0700 (PDT)

Beginning of doc string:

  Read file name, prompting with PROMPT and completing in directory DIR.
  Value is not expanded---you must call `expand-file-name' yourself.

What value?  This could easily be misread to be referring to the value
of DIR.  Please say clearly that it is the return value of function
`read-file-name' that is not expanded.

In GNU Emacs 24.3.50.1 (i686-pc-mingw32)
 of 2013-08-07 on ODIEONE
Bzr revision: 113750 lekktu <at> gmail.com-20130808011911-0jzpc9xuncegg6x9
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --prefix=/c/Devel/emacs/binary --enable-checking=yes,glyphs
 CFLAGS=-O0 -g3 LDFLAGS=-Lc:/Devel/emacs/lib
 CPPFLAGS=-Ic:/Devel/emacs/include'
Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#15096; Package emacs. (Sat, 08 Feb 2014 05:18:02 GMT) Full text and rfc822 format available.

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 15096 <at> debbugs.gnu.org
Subject: Re: bug#15096: 24.3.50;
 doc string of `read-file-name' - "value is not expanded"
Date: Fri, 07 Feb 2014 21:15:44 -0800

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

> Beginning of doc string:
>
>   Read file name, prompting with PROMPT and completing in directory DIR.
>   Value is not expanded---you must call `expand-file-name' yourself.
>
> What value?  This could easily be misread to be referring to the value
> of DIR.  Please say clearly that it is the return value of function
> `read-file-name' that is not expanded.

Fixed in trunk.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/
bug marked as fixed in version 24.4, send any further explanations to 15096 <at> debbugs.gnu.org and Drew Adams <drew.adams <at> oracle.com> Request was from Lars Ingebrigtsen <larsi <at> gnus.org> to control <at> debbugs.gnu.org. (Sat, 08 Feb 2014 05:18:03 GMT) Full text and rfc822 format available.
bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Sat, 08 Mar 2014 12:24:08 GMT) Full text and rfc822 format available.
This bug report was last modified 10 years and 63 days ago.

Previous Next

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