GNU bug report logs - #17299
24.4.50; `C-h f' for alias is wrong

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 17299 in the body.
You can then email your comments to 17299 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.4.50; `C-h f' for alias is wrong
Date: Sat, 19 Apr 2014 08:15:28 -0700 (PDT)

emacs -Q

(defun rn (prompt &optional default) (message "RN"))
(defalias 'read-number 'rn)

C-h f read-number

,----
| read-number is an alias for `rn' in `subr.el'.
| 
| (read-number PROMPT &optional DEFAULT)
| 
| Not documented.
`----

It is incorrect to refer to `subr.el' at all.  There is nothing in
`subr.el' that is related to the current definition of `read-number'.
This misleads users.  Better not to send users anywhere than to send
them to the wrong definition of the function.

In GNU Emacs 24.4.50.1 (i686-pc-mingw32)
 of 2014-04-16 on ODIEONE
Bzr revision: 116980 lekktu <at> gmail.com-20140416100338-8e5o24izbuy085jr
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --prefix=/c/Devel/emacs/snapshot/trunk
 --enable-checking=yes,glyphs 'CFLAGS=-O0 -g3'
 LDFLAGS=-Lc:/Devel/emacs/lib 'CPPFLAGS=-DGC_MCHECK=1
 -Ic:/Devel/emacs/include''

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 17299 <at> debbugs.gnu.org
Subject: Re: bug#17299: 24.4.50; `C-h f' for alias is wrong
Date: Fri, 29 Apr 2016 21:56:50 +0200

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

> (defun rn (prompt &optional default) (message "RN"))
> (defalias 'read-number 'rn)
>
> C-h f read-number
>
> ,----
> | read-number is an alias for `rn' in `subr.el'.
> | 
> | (read-number PROMPT &optional DEFAULT)
> | 
> | Not documented.
> `----

I get

read-number is an alias for ‘rn’.

(read-number PROMPT &optional DEFAULT)

Not documented.

so I guess this has been fixed.

-- 
(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.