From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Sun, 16 Mar 2025 15:52:48 +0000 (+0100)
Subject: [3.13] gh-131327: Document winsound.SND_APPLICATION (GH-131328) (#131330)
X-Git-Tag: v3.13.3~122
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=4d7d249a0560d377b5a4c7fc0999bfa7ef5d67fd;p=thirdparty%2FPython%2Fcpython.git

[3.13] gh-131327: Document winsound.SND_APPLICATION (GH-131328) (#131330)

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 f7ca9dc57bbe..799fb3dea195 100644
--- 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 094c77ae34d6..1cb42f2f3bdf 100644
--- a/PC/winsound.c
+++ b/PC/winsound.c
@@ -56,6 +56,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.");