GNU bug report logs - #12346
24.2.50; doc of `set-temporary-overlay-map'

Previous Next

Package: emacs;

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

Date: Tue, 4 Sep 2012 02:59:01 UTC

Severity: minor

Merged with 11818

Found in versions 24.1.50, 24.2.50

Done: Glenn Morris <rgm <at> gnu.org>

Bug is archived. No further changes may be made.

Full log


View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Glenn Morris <rgm <at> gnu.org>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#11818: closed (24.1.50; The useful function `set-temporary-overlay-map'
 is not documented)
Date: Tue, 11 Sep 2012 17:33:03 +0000
[Message part 1 (text/plain, inline)]
Your message dated Tue, 11 Sep 2012 13:32:12 -0400
with message-id <a6d31sv52b.fsf <at> fencepost.gnu.org>
and subject line Re: bug#12346: 24.2.50; doc of `set-temporary-overlay-map'
has caused the debbugs.gnu.org bug report #12346,
regarding 24.1.50; The useful function `set-temporary-overlay-map' is not documented
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
12346: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=12346
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems
[Message part 2 (message/rfc822, inline)]
From: Damien Cassou <damien.cassou <at> gmail.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 24.1.50;
	The useful function `set-temporary-overlay-map' is not documented
Date: Fri, 29 Jun 2012 19:20:08 +0200
Hi,

the function `set-temporary-overlay-map' seems to be useful for elisp
developers but is not documented. I propose the following documentation:

"Set a new keymap that will only exist for a short period of time.

The new keymap to use must be given in the MAP variable. When to remove
the keymap depends on user input and KEEP-PRED:

- if KEEP-PRED is nil (the default), the keymap disappears as soon as
  any key is pressed, whether or not the key is in MAP;

- if KEEP-PRED is t, the keymap disappears as soon as a key *not* in MAP
  is pressed;

- otherwise, KEEP-PRED must be a 0-arguments predicate that will decide
  if the keymap should be removed (if predicate returns nil) or kept
  (otherwise). The predicate will be called after each key sequence."

In GNU Emacs 24.1.50.1 (i686-pc-linux-gnu, GTK+ Version 3.4.2)
 of 2012-06-28 on iridium, modified by Debian


[Message part 3 (message/rfc822, inline)]
From: Glenn Morris <rgm <at> gnu.org>
To: 12346-done <at> debbugs.gnu.org
Subject: Re: bug#12346: 24.2.50; doc of `set-temporary-overlay-map'
Date: Tue, 11 Sep 2012 13:32:12 -0400
Bastien wrote:

> I'm not closing this bug as I didn't update the manual, 

There's no need to keep this open, since it is in NEWS without +++/---
markup, like many other things, so the manual issue will be dealt with
before next release.

(BTW, this was previously reported with an actual patch:
http://debbugs.gnu.org/11818 )


This bug report was last modified 12 years and 252 days ago.

Previous Next


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