Documented Beep() function.

diff --git a/Doc/lib/libwinsound.tex b/Doc/lib/libwinsound.tex
index eacab3be342bb663360adc38e0a27f2991d3d893..153088dd7078401636d2447860c7031f32326ada 100644 (file)
--- a/Doc/lib/libwinsound.tex
+++ b/Doc/lib/libwinsound.tex
@@ -10,9 +10,19 @@
 \versionadded{1.5.2}
 
 The \module{winsound} module provides access to the basic
-sound-playing machinery provided by Windows platforms.  It includes a
-single function and several constants.
-
+sound-playing machinery provided by Windows platforms.  It includes
+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
+  able to beep the speaker, \exception{RuntimeError} is raised.
+  \versionadded{1.5.3} % XXX fix this version number when release is scheduled!
+\end{funcdesc}
 
 \begin{funcdesc}{PlaySound}{sound, flags}
   Call the underlying \cfunction{PlaySound()} function from the