Move iswitchb.el to obsolete/

Ref: http://lists.gnu.org/archive/html/emacs-devel/2013-11/msg00501.html

* lisp/obsolete/iswitchb.el: Move to obsolete/.

* lisp/simple.el (iswitchb-mode): Add manual autoloads to ease transition,
since obsolete/ is not scanned for autoloads.

* lisp/emacs-lisp/authors.el (authors-valid-file-names):
Add iswitchb.el.

* doc/emacs/ack.texi (Acknowledgments): No longer mention obsolete files.

* doc/misc/viper.texi (File and Buffer Handling): Prefer ido to iswitchb.

* etc/NEWS: Related edits.

4 files changed, 42 insertions, 2 deletions

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index e77adedb23f..18587c06e31 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,5 +1,11 @@
 2014-02-07  Glenn Morris  <rgm@gnu.org>
 
+        * obsolete/iswitchb.el: Move to obsolete/.
+        * simple.el (iswitchb-mode): Add manual autoloads to ease transition,
+        since obsolete/ is not scanned for autoloads.
+        * emacs-lisp/authors.el (authors-valid-file-names):
+        Add iswitchb.el.
+
         * obsolete/meese.el: Restore as obsolete (deleted 2014-01-11).
         Disable now non-functional find-file-hook.
 
diff --git a/lisp/emacs-lisp/authors.el b/lisp/emacs-lisp/authors.el
index 166e2134cb9..dfc60512c61 100644
--- a/lisp/emacs-lisp/authors.el
+++ b/lisp/emacs-lisp/authors.el
@@ -626,7 +626,7 @@ Changes to files in this list are not listed.")
     "erc-hecomplete.el"
     "eshell/esh-maint.el"
     "language/persian.el"
-    "meese.el"
+    "meese.el" "iswitchb.el"
     "mh-exec.el" "mh-init.el" "mh-customize.el"
     "net/zone-mode.el" "xesam.el"
     "term/mac-win.el" "sup-mouse.el"
diff --git a/lisp/iswitchb.el b/lisp/obsolete/iswitchb.el
index 5690d9c4e3f..c1313b8a00f 100644
--- a/lisp/iswitchb.el
+++ b/lisp/obsolete/iswitchb.el
@@ -5,6 +5,7 @@
 ;; Author: Stephen Eglen <stephen@gnu.org>
 ;; Maintainer: Stephen Eglen <stephen@gnu.org>
 ;; Keywords: completion convenience
+;; Obsolete-since: 24.4
 
 ;; This file is part of GNU Emacs.
 
@@ -23,6 +24,8 @@
 
 ;;; Commentary:
 
+;; This file is obsolete - use icomplete-mode or ido-mode instead.
+
 ;; Installation:
 ;; To get the functions in this package bound to keys, use
 ;; M-x iswitchb-mode or customize the option `iswitchb-mode'.
@@ -1413,6 +1416,9 @@ See the variable `iswitchb-case' for details."
           (isearch-no-upper-case-p iswitchb-text)
         (isearch-no-upper-case-p iswitchb-text t))))
 
+;; NB obsolete/ is not scanned for autoloads.
+;; If you change any of the following doc, copy the changes to simple.el.
+
 ;;;###autoload
 (define-minor-mode iswitchb-mode
   "Toggle Iswitchb mode.
@@ -1427,8 +1433,9 @@ between buffers using substrings.  See `iswitchb' for details."
       (add-hook 'minibuffer-setup-hook 'iswitchb-minibuffer-setup)
     (remove-hook 'minibuffer-setup-hook 'iswitchb-minibuffer-setup)))
 
+;;;###autoload
 (make-obsolete 'iswitchb-mode
-               "use icomplete-mode or ido-mode instead" "24.4")
+               "use `icomplete-mode' or `ido-mode' instead." "24.4")
 
 (provide 'iswitchb)
 
diff --git a/lisp/simple.el b/lisp/simple.el
index 2e924c857da..f1955b58500 100644
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -7766,6 +7766,33 @@ contains the list of implementations currently supported for this command."
            (message ,(format "No implementation selected for command `%s'"
                              command-name)))))))
 
+
+;; This is here because files in obsolete/ are not scanned for autoloads.
+
+(defvar iswitchb-mode nil "\
+Non-nil if Iswitchb mode is enabled.
+See the command `iswitchb-mode' for a description of this minor mode.
+Setting this variable directly does not take effect;
+either customize it (see the info node `Easy Customization')
+or call the function `iswitchb-mode'.")
+
+(custom-autoload 'iswitchb-mode "iswitchb" nil)
+
+(autoload 'iswitchb-mode "iswitchb" "\
+Toggle Iswitchb mode.
+With a prefix argument ARG, enable Iswitchb mode if ARG is
+positive, and disable it otherwise.  If called from Lisp, enable
+the mode if ARG is omitted or nil.
+
+Iswitchb mode is a global minor mode that enables switching
+between buffers using substrings.  See `iswitchb' for details.
+
+\(fn &optional ARG)" t nil)
+
+(make-obsolete 'iswitchb-mode
+               "use `icomplete-mode' or `ido-mode' instead." "24.4")
+
+
 (provide 'simple)
 
 ;;; simple.el ends here