Doc play-sound-file and sound :device.

1 files changed, 10 insertions, 0 deletions

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