From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Mon, 10 Feb 2014 05:55:53 +0000 (-0800)
Subject: * fns.c (Fmaphash): Say what `maphash' returns, since it may be unintuitive.
X-Git-Tag: emacs-24.3.90~173^2^2~42^2~45^2~49
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=a3a8a7da5be16ccb572c1ff97194cc105bf940eb;p=emacs.git

* fns.c (Fmaphash): Say what `maphash' returns, since it may be unintuitive.

Fixes: debbugs:15824
---

diff --git a/src/ChangeLog b/src/ChangeLog
index a0b7c449b95..95e3056f035 100644
--- a/src/ChangeLog
+++ b/src/ChangeLog
@@ -1,3 +1,8 @@
+2014-02-10  Lars Ingebrigtsen  <larsi@gnus.org>
+
+	* fns.c (Fmaphash): Say what `maphash' returns, since it may be
+	unintuitive (bug#15824).
+
 2014-02-10  Dmitry Antipov  <dmantipov@yandex.ru>
 
 	* cmds.c (Fself_insert_command): Respect the width of EMACS_INT
diff --git a/src/fns.c b/src/fns.c
index bc5331358a4..eb69ce12816 100644
--- a/src/fns.c
+++ b/src/fns.c
@@ -4508,7 +4508,8 @@ DEFUN ("remhash", Fremhash, Sremhash, 2, 2, 0,
 
 DEFUN ("maphash", Fmaphash, Smaphash, 2, 2, 0,
        doc: /* Call FUNCTION for all entries in hash table TABLE.
-FUNCTION is called with two arguments, KEY and VALUE.  */)
+FUNCTION is called with two arguments, KEY and VALUE.
+`maphash' always returns nil.  */)
   (Lisp_Object function, Lisp_Object table)
 {
   struct Lisp_Hash_Table *h = check_hash_table (table);