From: Dave Love <fx@gnu.org>
Date: Tue, 28 Nov 2000 11:38:55 +0000 (+0000)
Subject: Doc play-sound-file and sound :device.
X-Git-Tag: emacs-pretest-21.0.92~17
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=a6b8df2fd76d81378aaa87c3ac7fc575cac07746;p=emacs.git

Doc play-sound-file and sound :device.
---

diff --git a/lispref/os.texi b/lispref/os.texi
index 91a15c8bfb2..41d07aa6d74 100644
--- a/lispref/os.texi
+++ b/lispref/os.texi
@@ -1754,6 +1754,10 @@ sound file.  We recommend using a unibyte string.
 This specifies how loud to play the sound.  It should be a number in the
 range of 0 to 1.  The default is to use whatever volume has been
 specified before.
+
+@item :device @var{device}
+This specifies the system device on which to play the sound, as a
+string.  The default device is system-dependent.
 @end table
 
 Before actually playing the sound, @code{play-sound}
@@ -1761,6 +1765,12 @@ calls the functions in the list @code{play-sound-functions}.
 Each function is called with one argument, @var{sound}.
 @end defun
 
+@defun play-sound-file file &optional volume device
+@tindex play-sound-file
+This function is an alternative interface to playing a sound @var{file}
+specifying an optional @var{volume} and @var{device}.
+@end defun
+
 @tindex play-sound-functions
 @defvar play-sound-functions
 A list of functions to be called before playing a sound.  Each function