From: Bastien Guerry <bastien1@free.fr>
Date: Tue, 11 Sep 2012 16:45:31 +0000 (+0200)
Subject: * subr.el (set-temporary-overlay-map): Add a docstring.  (bug#12346)
X-Git-Tag: emacs-24.2.90~319
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=baa26ea03380c3c5f17e9e0c2f47e7509a69895a;p=emacs.git

* subr.el (set-temporary-overlay-map): Add a docstring.  (bug#12346)

Bug #12346 is not closed as this commit does not document
`set-temporary-overlay-map' in the manual.
---

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 5864f61403b..cdc021d192f 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,8 @@
+2012-09-11  Bastien Guerry  <bzg@gnu.org>
+
+	* subr.el (set-temporary-overlay-map): Add a docstring.
+	(bug#12346)
+
 2012-09-11  Bastien Guerry  <bzg@gnu.org>
 
 	* minibuffer.el (completion-table-subvert): Fix docstring.
diff --git a/lisp/subr.el b/lisp/subr.el
index be785ff8fba..23b62b25c9c 100644
--- a/lisp/subr.el
+++ b/lisp/subr.el
@@ -3911,6 +3911,11 @@ The properties used on SYMBOL are `composefunc', `sendfunc',
   (put symbol 'hookvar (or hookvar 'mail-send-hook)))
 
 (defun set-temporary-overlay-map (map &optional keep-pred)
+  "Set MAP as a temporary overlay map.
+When KEEP-PRED is `t', using a key from the temporary keymap
+leaves this keymap activated.  KEEP-PRED can also be a function,
+which will have the same effect when it returns `t'.
+When KEEP-PRED is nil, the temporary keymap is used only once."
   (let* ((clearfunsym (make-symbol "clear-temporary-overlay-map"))
          (overlaysym (make-symbol "t"))
          (alist (list (cons overlaysym map)))