GNU bug report logs - #12061
24.1; doc string of `map-char-table'

Previous Next

Package: emacs;

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

Date: Thu, 26 Jul 2012 20:04:02 UTC

Severity: minor

Found in version 24.1

Done: Chong Yidong <cyd <at> gnu.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 12061 in the body.
You can then email your comments to 12061 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#12061; Package emacs. (Thu, 26 Jul 2012 20:04:02 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. (Thu, 26 Jul 2012 20:04: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.1; doc string of `map-char-table'
Date: Thu, 26 Jul 2012 12:56:45 -0700

The doc string does not describe the VALUE parameter of FUNCTION: what
its type is or what it does/means.  How can someone use `map-char-table'
and come up with a FUNCTION without knowing what the parameters are for?
 
This information, from the Elisp manual, is apparently missing:
 
 "The value is what `(char-table-range CHAR-TABLE KEY)' returns."
 
But even that does not seem to be enough to make sense of FUNCTION.

In GNU Emacs 24.1.1 (i386-mingw-nt5.1.2600)
 of 2012-06-10 on MARVIN
Windowing system distributor `Microsoft Corp.', version 5.1.2600
Configured using:
 `configure --with-gcc (4.6) --cflags
 -ID:/devel/emacs/libs/libXpm-3.5.8/include
 -ID:/devel/emacs/libs/libXpm-3.5.8/src
 -ID:/devel/emacs/libs/libpng-dev_1.4.3-1/include
 -ID:/devel/emacs/libs/zlib-dev_1.2.5-2/include
 -ID:/devel/emacs/libs/giflib-4.1.4-1/include
 -ID:/devel/emacs/libs/jpeg-6b-4/include
 -ID:/devel/emacs/libs/tiff-3.8.2-1/include
 -ID:/devel/emacs/libs/gnutls-3.0.9/include'
Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#12061; Package emacs. (Tue, 14 Aug 2012 16:31:02 GMT) Full text and rfc822 format available.

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

From: Chong Yidong <cyd <at> gnu.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 12061 <at> debbugs.gnu.org
Subject: Re: bug#12061: 24.1; doc string of `map-char-table'
Date: Wed, 15 Aug 2012 00:21:57 +0800

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

> The doc string does not describe the VALUE parameter of FUNCTION: what
> its type is or what it does/means.

Fixed in trunk.
bug closed, send any further explanations to 12061 <at> debbugs.gnu.org and "Drew Adams" <drew.adams <at> oracle.com> Request was from Chong Yidong <cyd <at> gnu.org> to control <at> debbugs.gnu.org. (Tue, 14 Aug 2012 16:31: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. (Wed, 12 Sep 2012 11:24:04 GMT) Full text and rfc822 format available.
This bug report was last modified 11 years and 241 days ago.

Previous Next

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