GNU bug report logs - #6043
23.1.96; doc of called-interactively and interactive-p

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 6043 in the body.
You can then email your comments to 6043 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: 23.1.96; doc of called-interactively and interactive-p
Date: Mon, 26 Apr 2010 15:02:59 -0700

1. The doc for `called-interactively-p' and interactive-p is still a
mess.
 
The doc string for `called-interactively-p' says it has one mandatory
arg. The Elisp manual says it has none. Which is it? The doc string
says that with arg `any' it returns t when in `noninteractive' mode.
The manual says the exact opposite: it returns t if `noninteractive'
is nil.
 
And the `interactive-p' doc string says that it is is obsolete, whereas
the manual documents it normally. Which is it?
 
2. Why isn't the arg for `called-interactively-p' optional, as I
proposed in the bug #3936 thread? Or maybe it is, and the doc string
is wrong in that way too?
 
(called-interactively-p) raises no error with no arg. Calling it
with no arg seems to have the same effect as calling it with arg
`any'. And calling it with any arg other than `interactive' seems
to have the same effect as calling it with arg `any'. And calling
it with arg `interactive' seems to have the same effect as
function `interactive-p'.

 

In GNU Emacs 23.1.96.1 (i386-mingw-nt5.1.2600)
 of 2010-04-20 on G41R2F1
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4) --no-opt --cflags -Ic:/xpm/include'
 

Message #10 received at 6043-done <at> debbugs.gnu.org (full text, mbox):

From: Chong Yidong <cyd <at> gnu.org>
To: 6043-done <at> debbugs.gnu.org
Subject: Re: 23.1.96; doc of called-interactively and interactive-p
Date: Sat, 28 Jan 2012 12:39:19 +0800

> The doc string for `called-interactively-p' says it has one mandatory
> arg. The Elisp manual says it has none. Which is it? The doc string
> says that with arg `any' it returns t when in `noninteractive' mode.
> The manual says the exact opposite: it returns t if `noninteractive'
> is nil.
> 
> And the `interactive-p' doc string says that it is is obsolete,
> whereas the manual documents it normally. Which is it?
 
All these doc issues were fixed some time ago.  Closing the bug.

Previous Next

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