Make yow.el obsolete

* lisp/play/yow.el: Move to obsolete/. 

* doc/emacs/ack.texi (Acknowledgments): Don't mention yow any more.

* doc/misc/message.texi (News Headers): Don't mention yow any more.

* etc/NEWS: Mention this.

Fixes: debbugs:9384

7 files changed, 23 insertions, 9 deletions

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index e5404a15c59..ba6f7e323e0 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,7 @@
+2013-02-13  Glenn Morris  <rgm@gnu.org>
+
+        * ack.texi (Acknowledgments): Don't mention yow any more.
+
 2013-02-13  Paul Eggert  <eggert@cs.ucla.edu>
 
         * cmdargs.texi (General Variables):
diff --git a/doc/emacs/ack.texi b/doc/emacs/ack.texi
index 99e0c690a09..718a51c60db 100644
--- a/doc/emacs/ack.texi
+++ b/doc/emacs/ack.texi
@@ -811,9 +811,8 @@ Richard Mlynarik wrote @file{cl-indent.el}, a package for indenting
 Common Lisp code; @file{ebuff-menu.el}, an ``electric'' browser for
 buffer listings; @file{ehelp.el}, bindings for browsing help screens;
 @file{rfc822.el}, a parser for E-mail addresses in the RFC-822 format,
-used in mail messages and news articles; @file{terminal.el}, a
-terminal emulator for Emacs subprocesses; and @file{yow.el}, an
-essential utility.
+used in mail messages and news articles; and @file{terminal.el}, a
+terminal emulator for Emacs subprocesses.
 
 @item
 Gerd Moellmann was the Emacs maintainer from the beginning of Emacs 21
diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index 11ff3700da4..dd3c0ccd1e2 100644
--- a/doc/misc/ChangeLog
+++ b/doc/misc/ChangeLog
@@ -1,3 +1,7 @@
+2013-02-13  Glenn Morris  <rgm@gnu.org>
+
+        * message.texi (News Headers): Don't mention yow any more.
+
 2013-02-09  Jay Belanger  <jay.p.belanger@gmail.com>
 
         * calc.texi (Basic Operations on Units):
diff --git a/doc/misc/message.texi b/doc/misc/message.texi
index 4d5d82aa6bd..a98c7e48e53 100644
--- a/doc/misc/message.texi
+++ b/doc/misc/message.texi
@@ -1817,17 +1817,14 @@ a string nor @code{nil}, use the user name only.  However, it is highly
 unlikely that you should need to fiddle with this variable at all.
 @end table
 
-@findex yow
 @cindex Mime-Version
 In addition, you can enter conses into this list.  The @sc{car} of this cons
 should be a symbol.  This symbol's name is the name of the header, and
 the @sc{cdr} can either be a string to be entered verbatim as the value of
 this header, or it can be a function to be called.  This function should
-return a string to be inserted.  For instance, if you want to insert
-@code{Mime-Version: 1.0}, you should enter @code{(Mime-Version . "1.0")}
-into the list.  If you want to insert a funny quote, you could enter
-something like @code{(X-Yow . yow)} into the list.  The function
-@code{yow} will then be called without any arguments.
+take no arguments, and return a string to be inserted.  For
+instance, if you want to insert @code{Mime-Version: 1.0}, you should
+enter @code{(Mime-Version . "1.0")} into the list.
 
 If the list contains a cons where the @sc{car} of the cons is
 @code{optional}, the @sc{cdr} of this cons will only be inserted if it is
diff --git a/etc/NEWS b/etc/NEWS
index 6891f1019bd..05d2f7edb06 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -201,6 +201,9 @@ are obsolete.  Customize the `woman-* faces instead.
 
 *** terminal.el is obsolete; use term.el instead.
 
++++
+*** yow.el is obsolete; use fortune.el or cookie1.el instead.
+
 
 * New Modes and Packages in Emacs 24.4
 ** New nadvice.el package offering lighter-weight advice facilities.
diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 172af2f4efd..d7c7ed7218f 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,7 @@
+2013-02-13  Glenn Morris  <rgm@gnu.org>
+
+        * play/yow.el: Move to obsolete/.  (Bug#9384)
+
 2013-02-13  Juri Linkov  <juri@jurta.org>
 
         * vc/ediff-util.el (ediff-recenter): Use `select-frame-set-input-focus'
diff --git a/lisp/play/yow.el b/lisp/obsolete/yow.el
index 10c69347469..42bb0a0b354 100644
--- a/lisp/play/yow.el
+++ b/lisp/obsolete/yow.el
@@ -5,6 +5,7 @@
 ;; Maintainer: FSF
 ;; Author: Richard Mlynarik
 ;; Keywords: games
+;; Obsolete-since: 24.4
 
 ;; This file is part of GNU Emacs.
 
@@ -24,6 +25,8 @@
 ;;; Commentary:
 
 ;; Important pinheadery for GNU Emacs.
+;; This file is obsolete.  For similar functionality, see
+;; fortune.el and cookie1.el.
 
 ;;; Code: