Better documentation for pygame.sound.copy

pygame-community · Nov 27, 2024 · 726244d · 726244d
1 parent 3be9a1c
commit 726244d
Show file tree

Hide file tree

Showing 2 changed files with 5 additions and 3 deletions.
diff --git a/docs/reST/ref/mixer.rst b/docs/reST/ref/mixer.rst
@@ -485,7 +485,8 @@ The following file formats are supported
       | :sg:`copy() -> Sound`
 
       Return a new Sound object that is a deep copy of this one. The new Sound will
-      be playable just like the original. If the copy fails, the method returns ``NULL``.
+      be playable just like the original. If the copy fails,  a ``MemoryError`` or a
+      :meth:`pygame.error` exception will be raised.
 
       .. ## Sound.copy ##
 

diff --git a/src_c/mixer.c b/src_c/mixer.c
@@ -845,7 +845,7 @@ snd_copy(PyObject *self, PyObject *_null)
     new_sound =
         (pgSoundObject *)pgSound_Type.tp_new(Py_TYPE(self), NULL, NULL);
     if (!new_sound) {
-        PyErr_SetString(PyExc_RuntimeError,
+        PyErr_SetString(PyExc_MemoryError,
                         "Failed to allocate memory for new sound object");
         return NULL;
     }
@@ -867,7 +867,7 @@ snd_copy(PyObject *self, PyObject *_null)
         if (!new_chunk) {
             free(buffer_copy);
             Py_DECREF(new_sound);
-            PyErr_SetString(PyExc_RuntimeError,
+            PyErr_SetString(pgExc_SDLError,
                             "Failed to create new sound chunk");
             return NULL;
         }
@@ -909,6 +909,7 @@ PyMethodDef sound_methods[] = {
     {"get_length", snd_get_length, METH_NOARGS, DOC_MIXER_SOUND_GETLENGTH},
     {"get_raw", snd_get_raw, METH_NOARGS, DOC_MIXER_SOUND_GETRAW},
     {"copy", snd_copy, METH_NOARGS, DOC_MIXER_SOUND_COPY},
+    {"__copy__", snd_copy, METH_NOARGS, DOC_MIXER_SOUND_COPY},
     {NULL, NULL, 0, NULL}};
 
 static PyGetSetDef sound_getset[] = {