[3.12] gh-131327: Document winsound.SND_APPLICATION (GH-131328) (#131329)

gh-131327: Document winsound.SND_APPLICATION (GH-131328)
(cherry picked from commit bf4c1bf344ed1f80c4e8f4fd5b1a8f0e0858777e)

Co-authored-by: AN Long <aisk@users.noreply.github.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>

diff --git a/Doc/library/winsound.rst b/Doc/library/winsound.rst
index f7ca9dc57bbe285a902f85f40de48c904aa0209d..799fb3dea19501a82b4519b0855fad19fb1ee953 100644 (file)
--- a/Doc/library/winsound.rst
+++ b/Doc/library/winsound.rst
@@ -135,6 +135,13 @@ provided by Windows platforms.  It includes functions and several constants.
       This flag is not supported on modern Windows platforms.
 
 
+.. data:: SND_APPLICATION
+
+   The *sound* parameter is an application-specific alias in the registry.
+   This flag can be combined with the :const:`SND_ALIAS` flag
+   to specify an application-defined sound alias.
+
+
 .. data:: MB_ICONASTERISK
 
    Play the ``SystemDefault`` sound.

diff --git a/PC/winsound.c b/PC/winsound.c
index 68a917810f884debe2833a7cdf2393da2f93e901..a73f3d7e8edcc9a72272083c94270de2a3fe374f 100644 (file)
--- a/PC/winsound.c
+++ b/PC/winsound.c
@@ -50,6 +50,7 @@ PyDoc_STRVAR(sound_module_doc,
 "SND_NODEFAULT - Do not play a default beep if the sound can not be found\n"
 "SND_NOSTOP - Do not interrupt any sounds currently playing\n"  // Raising RuntimeError if needed
 "SND_NOWAIT - Return immediately if the sound driver is busy\n" // Without any errors
+"SND_APPLICATION - sound is an application-specific alias in the registry."
 "\n"
 "Beep(frequency, duration) - Make a beep through the PC speaker.\n"
 "MessageBeep(type) - Call Windows MessageBeep.");