Do not document subr-x.el in the manuals

* doc/lispref/hash.texi (Other Hash): Do not mention subr-x.el functions;
reverts 2013-12-22 change.

* lisp/emacs-lisp/subr-x.el: Comment.

* etc/NEWS: Small related edits.

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 4044e96..78bc55a 100644 (file)
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2014-01-20  Glenn Morris  <rgm@gnu.org>
+
+       * hash.texi (Other Hash): Do not mention subr-x.el functions;
+       reverts 2013-12-22 change.
+
 2014-01-10  Stefan Monnier  <monnier@iro.umontreal.ca>
 
        * functions.texi (Advising Functions): New section.

diff --git a/doc/lispref/hash.texi b/doc/lispref/hash.texi
index 5d0d6b6..0c82bb5 100644 (file)
--- a/doc/lispref/hash.texi
+++ b/doc/lispref/hash.texi
@@ -353,14 +353,3 @@ This returns the rehash threshold of @var{table}.
 @defun hash-table-size table
 This returns the current nominal size of @var{table}.
 @end defun
-
-The following two functions are provided by the @file{subr-x} library.
-To use them, you need to load this library first.
-
-@defun hash-table-keys hash-table
-This returns a list of keys in @var{hash-table}.
-@end defun
-
-@defun hash-table-values hash-table
-This returns a list of values in @var{hash-table}.
-@end defun

diff --git a/etc/NEWS b/etc/NEWS
index dff1cf6..2c6c1ea 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1081,12 +1081,10 @@ displaying the buffer in a window.
 ** New macro `with-eval-after-load'.
 This is like the old `eval-after-load', but better behaved.
 
-** New library subr-x.el for misc helper functions
-+++
+---
+** New library subr-x.el with miscellaneous small utility functions
 *** `hash-table-keys'
-+++
 *** `hash-table-values'
----
 *** `string-blank-p`
 *** `string-empty-p`
 *** `string-join`

diff --git a/lisp/emacs-lisp/subr-x.el b/lisp/emacs-lisp/subr-x.el
index 237d42c..69a7e9f 100644 (file)
--- a/lisp/emacs-lisp/subr-x.el
+++ b/lisp/emacs-lisp/subr-x.el
@@ -27,6 +27,9 @@
 ;; C code (like hash-tables and strings), and are not eligible for inclusion
 ;; in subr.el.
 
+;; Do not document these functions in the lispref.
+;; http://lists.gnu.org/archive/html/emacs-devel/2014-01/msg01006.html
+
 ;;; Code:
 
 (defsubst hash-table-keys (hash-table)