Deprecate sage.media.wav, since it is totally undoctested, and evidently full of confusing bugs

[williamstein]

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.

CC: @jasongrout @sagetrac-mhampton

Component: misc

Author: Matthias Koeppe

Branch/Commit: 2bf2bd0

Reviewer: Travis Scrimshaw

Issue created by migration from https://trac.sagemath.org/ticket/12673

[williamstein]

Attachment: trac_12673.patch.gz

[williamstein]

comment:2

Alternatively, doctest the code. I've attached a patch to delete it, but maybe that is too draconian.

[kcrisman]

comment:3

This is (very tangentially) related to #7668 and this interact by Marshall.

Given that it's not the worst to eventually have easy-to-use wave handling, perhaps it would be appropriate to split the difference between doctesting and deleting. Could one simply comment out all the code and raise (doctested?) NotImplementedErrors for everything here?

[jdemeyer]

comment:4

Please fill in your real name as Author.

[kcrisman]

comment:5

I've changed my mind. I think that we should just replace this by some really nice documentation about how to use the wave module, given this sage-devel discussion and this ask.sagemath question. What would be appropriate to roughly replace this stuff with?