summaryrefslogtreecommitdiffstats
path: root/Doc/lib/libwinsound.tex
diff options
context:
space:
mode:
authorTim Peters <tim.peters@gmail.com>2001-02-19 07:06:36 (GMT)
committerTim Peters <tim.peters@gmail.com>2001-02-19 07:06:36 (GMT)
commit25a9ce371c1b43094f5e108c3fff834833c68342 (patch)
tree653eb080911882bd491c39832f9e17c4ccdbcba2 /Doc/lib/libwinsound.tex
parentc761fc87d294f223b124239544b1cf2479ac5e18 (diff)
downloadcpython-25a9ce371c1b43094f5e108c3fff834833c68342.zip
cpython-25a9ce371c1b43094f5e108c3fff834833c68342.tar.gz
cpython-25a9ce371c1b43094f5e108c3fff834833c68342.tar.bz2
Take a tour of hell's seedier neighborhoods to try to make winsound.Beep()
do something non-useless on Win9X boxes. WinME unknown to me. Someone with NT/2000 make sure it still works there!
Diffstat (limited to 'Doc/lib/libwinsound.tex')
-rw-r--r--Doc/lib/libwinsound.tex15
1 files changed, 7 insertions, 8 deletions
diff --git a/Doc/lib/libwinsound.tex b/Doc/lib/libwinsound.tex
index 589658f..317e206 100644
--- a/Doc/lib/libwinsound.tex
+++ b/Doc/lib/libwinsound.tex
@@ -17,15 +17,14 @@ two functions and several constants.
\begin{funcdesc}{Beep}{frequency, duration}
Beep the PC's speaker.
The \var{frequency} parameter specifies frequency, in hertz, of the
- sound, and must be in the range 37 through 32,767 (\code{0x25}
- through \code{0x7fff}). The \var{duration} parameter specifies the
- number of milliseconds the sound should last. If the system is not
+ sound, and must be in the range 37 through 32,767.
+ The \var{duration} parameter specifies the number of milliseconds the
+ sound should last. If the system is not
able to beep the speaker, \exception{RuntimeError} is raised.
- \strong{Note:} Under Windows 95 and 98, the arguments are ignored;
- if the system has a sound card, the system default sound is played
- (typically \file{ding.wav}, or whatever is registered as the default
- sound via Control Panel -> Sounds); else (no sound card) the
- standard system beep.
+ \strong{Note:} Under Windows 95 and 98, the Windows \cfunction{Beep()}
+ function exists but is useless (it ignores its arguments). In rhat
+ case Python simulates it via direct port manipulation (added in version
+ 2.1). It's unknown whether that will work on all systems.
\versionadded{1.6}
\end{funcdesc}