Trac #12673: Deprecate sage.media.wav, since it is totally undocteste…

…d, and evidently full of confusing bugs

As I think http://480.sagenb.org/home/pub/137/ amply illustrates, the
mere existence of the untested and very buggy module sage.media.wav
causes more confusion than it is worth for now.  It would be best to
remove it from Sage, and only add something back as a result of a new
(probably student) project to do things right.

URL: https://trac.sagemath.org/12673
Reported by: was
Ticket author(s): Matthias Koeppe
Reviewer(s): Travis Scrimshaw

src/sage/all.py

@@ -188,7 +188,7 @@
 
 from sage.games.all      import *
 
-from sage.media.all      import *
+lazy_import('sage.media.wav', 'Wave', as_='wave', deprecation=12673)
 
 from sage.logic.all      import *
 

src/sage/media/__init__.py

@@ -0,0 +1,2 @@
+from sage.misc.superseded import deprecation
+deprecation(12673, "the package sage.media is deprecated")

src/sage/media/wav.py

@@ -23,6 +23,15 @@
 - Bobby Moretti and Gonzalo Tornaria (2007-07-01): First version
 - William Stein (2007-07-03): add more
 - Bobby Moretti (2007-07-03): add doctests
+
+This module (and all of ``sage.media``) is deprecated.
+
+EXAMPLES::
+
+    sage: import sage.media
+    doctest:warning...
+    DeprecationWarning: the package sage.media is deprecated
+    See http://trac.sagemath.org/12673 for details.
 """
 
 import math