GNU bug report logs - #15422
24.3.50; `read-string': different parameter name from `read-from-minibuffer'

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 15422 in the body.
You can then email your comments to 15422 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.3.50; `read-string': different parameter name from
 `read-from-minibuffer'
Date: Fri, 20 Sep 2013 08:02:17 -0700 (PDT)

`read-string' calls its parameter INITIAL-INPUT.
`read-from-minibuffer' calls its parameter INITIAL-CONTENTS.

But the doc string of `read-string' says that parameter INITIAL-INPUT
"behaves as in `read-from-minibuffer'", which clearly makes no sense
since `r-f-m' has no such parameter.

The two should have the same name if the doc for one refers to the
other.



In GNU Emacs 24.3.50.1 (i686-pc-mingw32)
 of 2013-08-31 on ODIEONE
Bzr revision: 114088 rgm <at> gnu.org-20130901021232-sazo0qla2qgcko95
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'

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 15422 <at> debbugs.gnu.org
Subject: Re: bug#15422: 24.3.50;
 `read-string': different parameter name from `read-from-minibuffer'
Date: Fri, 29 Apr 2016 15:45:46 +0200

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

> `read-string' calls its parameter INITIAL-INPUT.
> `read-from-minibuffer' calls its parameter INITIAL-CONTENTS.
>
> But the doc string of `read-string' says that parameter INITIAL-INPUT
> "behaves as in `read-from-minibuffer'", which clearly makes no sense
> since `r-f-m' has no such parameter.
>
> The two should have the same name if the doc for one refers to the
> other.

Somebody has sneakily changed the doc string:

If non-nil, second arg INITIAL-INPUT is a string to insert before reading.
  This argument has been superseded by DEFAULT-VALUE and should normally be nil
  in new code.  It behaves as INITIAL-CONTENTS in ‘read-from-minibuffer’ (which
  see).


-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

Previous Next

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