GNU bug report logs - #8422
24.0.50; doc of `apropos-internal'

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 8422 in the body.
You can then email your comments to 8422 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.0.50; doc of `apropos-internal'
Date: Mon, 4 Apr 2011 09:13:39 -0700

Please add to the doc string some info about what the context is
when/where PREDICATE is invoked.  Suppose, for instance, you wanted to
use a PREDICATE such as this:
 
(lambda (c)
  (and (commandp c)
       (where-is-internal c overriding-local-map 'non-ascii))
 
The behavior of the PREDICATE depends on which buffer is current when it
is invoked.  Can we assume that the buffer is the same one as when
`apropos-internal' was invoked?  Likewise wrt the selected window.
 
To find this info, users currently need to look at the C source code.

In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600)
 of 2011-04-04 on 3249CTO
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.5) --no-opt --cflags
-Ic:/imagesupport/include'
 

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

From: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 8422 <at> debbugs.gnu.org
Subject: Re: 24.0.50; doc of `apropos-internal'
Date: Fri, 15 Jul 2011 14:39:31 +0200

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

> Please add to the doc string some info about what the context is
> when/where PREDICATE is invoked.  Suppose, for instance, you wanted to
> use a PREDICATE such as this:
>
> (lambda (c)
>   (and (commandp c)
>        (where-is-internal c overriding-local-map 'non-ascii))
>
> The behavior of the PREDICATE depends on which buffer is current when it
> is invoked.  Can we assume that the buffer is the same one as when
> `apropos-internal' was invoked?  Likewise wrt the selected window.
>
> To find this info, users currently need to look at the C source code.

That sounds reasonable, but I'm not quite sure that's how the predicate
is meant to be used.  That is, I'm not sure it's an implementation
detail what buffer the predicate is called from, or whether it's
supposed to be that way.

Anybody know?

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

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 8422 <at> debbugs.gnu.org
Subject: Re: bug#8422: 24.0.50; doc of `apropos-internal'
Date: Thu, 28 Apr 2016 12:33:33 +0200

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

> Please add to the doc string some info about what the context is
> when/where PREDICATE is invoked.  Suppose, for instance, you wanted to
> use a PREDICATE such as this:
>
> (lambda (c)
>   (and (commandp c)
>        (where-is-internal c overriding-local-map 'non-ascii))
>
> The behavior of the PREDICATE depends on which buffer is current when it
> is invoked.  Can we assume that the buffer is the same one as when
> `apropos-internal' was invoked?  Likewise wrt the selected window.
>
> To find this info, users currently need to look at the C source code.

Uhm...  no.  As far as I can see, apropos-internal does nothing weird
like changing buffers or windows?  So it would be rather odd to document
that it doesn't do <one weird thing>.  Other mapping functions like
`sort' certainly doesn't.  Closing.

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

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

From: Drew Adams <drew.adams <at> oracle.com>
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: 8422 <at> debbugs.gnu.org
Subject: RE: bug#8422: 24.0.50; doc of `apropos-internal'
Date: Thu, 28 Apr 2016 06:48:15 -0700 (PDT)

> Uhm...  no.  As far as I can see, apropos-internal does nothing weird
> like changing buffers or windows?  So it would be rather odd to document
> that it doesn't do <one weird thing>.  Other mapping functions like
> `sort' certainly doesn't.  Closing.

That contradicts what a certain Lars Ingebrigtsen wrote in
this bug thread in 2011:

  > To find this info, users currently need to look at the C source code.

  That sounds reasonable, but I'm not quite sure that's how the predicate
  is meant to be used.  That is, I'm not sure it's an implementation
  detail what buffer the predicate is called from, or whether it's
  supposed to be that way.

  Anybody know?

Of course, we all have the right to change our minds. ;-)

Previous Next

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