gh-104773: PEP 594: Remove the audioop module (#104937)

Author: vstinner

Diff for: Doc/library/audioop.rst

@@ -10,7 +10,6 @@ backwards compatibility. They have been superseded by other modules.
 
 .. toctree::
 
-   audioop.rst
    chunk.rst
    imghdr.rst
    optparse.rst

Diff for: Doc/library/superseded.rst

@@ -988,31 +988,3 @@ https://www.w3.org/TR/xml-c14n2-testcases/ and is distributed under the
    THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
    (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
    OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
-
-Audioop
--------
-
-The audioop module uses the code base in g771.c file of the SoX project::
-
-    Programming the AdLib/Sound Blaster
-    FM Music Chips
-    Version 2.0 (24 Feb 1992)
-    Copyright (c) 1991, 1992 by Jeffrey S. Lee
-    jlee@smylex.uucp
-    Warranty and Copyright Policy
-    This document is provided on an "as-is" basis, and its author makes
-    no warranty or representation, express or implied, with respect to
-    its quality performance or fitness for a particular purpose.  In no
-    event will the author of this document be liable for direct, indirect,
-    special, incidental, or consequential damages arising out of the use
-    or inability to use the information contained within.  Use of this
-    document is at your own risk.
-    This file may be used and copied freely so long as the applicable
-    copyright notices are retained, and no modifications are made to the
-    text of the document.  No money shall be charged for its distribution
-    beyond reasonable shipping, handling and duplication costs, nor shall
-    proprietary changes be made to this document so that it cannot be
-    distributed freely.  This document may not be included in published
-    material or commercial packages without the written consent of its
-    author.

Diff for: Doc/license.rst

@@ -84,7 +84,6 @@ Doc/library/asyncio-policy.rst
 Doc/library/asyncio-stream.rst
 Doc/library/asyncio-subprocess.rst
 Doc/library/asyncio-task.rst
-Doc/library/audioop.rst
 Doc/library/bdb.rst
 Doc/library/bisect.rst
 Doc/library/bz2.rst

Diff for: Doc/tools/.nitignore

@@ -1222,7 +1222,7 @@ Here's a partial list of the most notable changes, sorted alphabetically by
 module name. Consult the :file:`Misc/NEWS` file in the source tree for a more
 complete list of changes, or look through the SVN logs for all the details.
 
-* The :mod:`audioop` module now supports the a-LAW encoding, and the code for
+* The :mod:`!audioop` module now supports the a-LAW encoding, and the code for
   u-LAW encoding has been improved.  (Contributed by Lars Immisch.)
 
 * The :mod:`codecs` module gained support for incremental codecs.  The

Diff for: Doc/whatsnew/2.5.rst

@@ -1733,7 +1733,7 @@ Modules
   +---------------------+---------------------+---------------------+---------------------+---------------------+
   | :mod:`!aifc`        | :mod:`chunk`        | :mod:`!msilib`      | :mod:`!pipes`       | :mod:`!telnetlib`   |
   +---------------------+---------------------+---------------------+---------------------+---------------------+
-  | :mod:`audioop`      | :mod:`!crypt`       | :mod:`!nis`         | :mod:`!sndhdr`      | :mod:`!uu`          |
+  | :mod:`!audioop`     | :mod:`!crypt`       | :mod:`!nis`         | :mod:`!sndhdr`      | :mod:`!uu`          |
   +---------------------+---------------------+---------------------+---------------------+---------------------+
   | :mod:`!cgi`         | :mod:`imghdr`       | :mod:`!nntplib`     | :mod:`!spwd`        | :mod:`!xdrlib`      |
   +---------------------+---------------------+---------------------+---------------------+---------------------+

Diff for: Doc/whatsnew/3.11.rst

@@ -919,7 +919,7 @@ and will be removed in Python 3.13.
 Modules (see :pep:`594`):
 
 * :mod:`!aifc`
-* :mod:`audioop`
+* :mod:`!audioop`
 * :mod:`!cgi`
 * :mod:`!cgitb`
 * :mod:`chunk`

Diff for: Doc/whatsnew/3.12.rst

@@ -224,6 +224,9 @@ Removed
 * :pep:`594`: Remove the :mod:`!aifc` module, deprecated in Python 3.11.
   (Contributed by Victor Stinner in :gh:`104773`.)
 
+* :pep:`594`: Remove the :mod:`!audioop` module, deprecated in Python 3.11.
+  (Contributed by Victor Stinner in :gh:`104773`.)
+
 
 Porting to Python 3.13
 ======================

Diff for: Doc/whatsnew/3.13.rst

@@ -629,14 +629,14 @@ by Lucas Maystre in :issue:`11175`.)
 audioop
 -------
 
-:mod:`audioop` now supports 24-bit samples.  (Contributed by Serhiy Storchaka
+:mod:`!audioop` now supports 24-bit samples.  (Contributed by Serhiy Storchaka
 in :issue:`12866`.)
 
-New :func:`~audioop.byteswap` function converts big-endian samples to
+New :func:`~!audioop.byteswap` function converts big-endian samples to
 little-endian and vice versa.  (Contributed by Serhiy Storchaka in
 :issue:`19641`.)
 
-All :mod:`audioop` functions now accept any :term:`bytes-like object`.  Strings
+All :mod:`!audioop` functions now accept any :term:`bytes-like object`.  Strings
 are not accepted: they didn't work before, now they raise an error right away.
 (Contributed by Serhiy Storchaka in :issue:`16685`.)
 
@@ -2434,7 +2434,7 @@ Changes in the Python API
   matched the input type, so if your code was depending on the return value
   being, say, a ``bytearray``, you will need to change your code.
 
-* :mod:`audioop` functions now raise an error immediately if passed string
+* :mod:`!audioop` functions now raise an error immediately if passed string
   input, instead of failing randomly later on (:issue:`16685`).
 
 * The new *convert_charrefs* argument to :class:`~html.parser.HTMLParser`