[src/trunk]: src/usr.bin/audio document new play -f/-s/-P-/c/-e, s/name/named...

[mrg <mrg%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/f69caa66dc91
branches:  trunk
changeset: 467877:f69caa66dc91
user:      mrg <mrg%NetBSD.org@localhost>
date:      Tue Mar 30 14:48:49 1999 +0000

description:
document new play -f/-s/-P-/c/-e, s/name/named/ from mason in pr#7292. update dates.

diffstat:

 usr.bin/audio/play/audioplay.1     |  61 ++++++++++++++++++++++++++++++++++---
 usr.bin/audio/record/audiorecord.1 |  18 ++++++++--
 2 files changed, 70 insertions(+), 9 deletions(-)

diffs (139 lines):

diff -r 76759e22e606 -r f69caa66dc91 usr.bin/audio/play/audioplay.1
--- a/usr.bin/audio/play/audioplay.1    Tue Mar 30 14:46:23 1999 +0000
+++ b/usr.bin/audio/play/audioplay.1    Tue Mar 30 14:48:49 1999 +0000
@@ -1,6 +1,6 @@
-.\"    $NetBSD: audioplay.1,v 1.2 1999/03/28 10:35:05 mrg Exp $
+.\"    $NetBSD: audioplay.1,v 1.3 1999/03/30 14:48:49 mrg Exp $
 .\"
-.\" Copyright (c) 1998 Matthew R. Green
+.\" Copyright (c) 1998-1999 Matthew R. Green
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -26,7 +26,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd October 19, 1998
+.Dd March 30, 1999
 .Dt AUDIOPLAY 1
 .Os NetBSD
 .Sh NAME
@@ -40,11 +40,18 @@
 .Op Fl p Ar port
 .Op Fl d Ar device
 .Op Fl C Ar ctl
+.Oo
+.Fl f
+.Op Fl c Ar channels
+.Op Fl e Ar encoding
+.Op Fl P Ar precision
+.Op Fl s Ar sample-rate
+.Oc
 .Op files ...
 .Sh DESCRIPTION
 The
 .Nm
-program copies the name audiofiles, or the standard input if no files are
+program copies the named audiofiles, or the standard input if no files are
 named, to the audio device.  The input files must contain a valid audio
 header, and the encoding must be understood by the underlying driver.
 .Sh OPTIONS
@@ -86,10 +93,44 @@
 .Ar ctl .
 The default is
 .Pa /dev/audioctl0 .
+.It Fl f
+Force playing, even if the format is unknown.  The
+.Fl f
+flag can be used in addition with the following flags to
+change the number of channels, encoding, precision and
+sample rate.
+.It Fl c
+when combined with the
+.Fl f
+option, sets the number of channels to it's argument.
+.It Fl e
+when combined with the
+.Fl f
+option, sets the encoding to it's argument
+.It Fl P
+when combined with the
+.Fl f
+option, sets the precision to it's argument.  This value must be either
+8, 16, 24 or 32.
+.It Fl s
+when combined with the
+.Fl f
+option, sets the sample rate to it's argument.  This value must be a
+valid value for the audio device or an error will be returned.
 .El
 .Sh NOTES
 .Nm
 can be used to play Sun/NeXT audio files, and also RIFF WAVE audio files.
+.Nm
+can be configured in the
+.Dq Netscape
+web browser as the program to use when playing audio files.
+.Sh ERRORS
+If the audio device or the control device can not be opened, and error is
+returned.
+.Pp
+If an invalid parameter is specified, an error is returned.  The set of
+valid values for any audio parameter is specified by the hardware driver.
 .Sh HISTORY
 The
 .Nm
@@ -105,4 +146,14 @@
 .Sh SEE ALSO
 .Xr audioctl 1 ,
 .Xr audiorecord 1 ,
-.Xr audio 4 .
+.Xr audioamd 4 ,
+.Xr aria 4 ,
+.Xr audio 4 ,
+.Xr eap 4 ,
+.Xr ess 4 ,
+.Xr gus 4 ,
+.Xr guspnp 4 ,
+.Xr sb 4 ,
+.Xr sv 4 ,
+.Xr wss 4 ,
+.Xr ym .
diff -r 76759e22e606 -r f69caa66dc91 usr.bin/audio/record/audiorecord.1
--- a/usr.bin/audio/record/audiorecord.1        Tue Mar 30 14:46:23 1999 +0000
+++ b/usr.bin/audio/record/audiorecord.1        Tue Mar 30 14:48:49 1999 +0000
@@ -1,6 +1,6 @@
-.\"    $NetBSD: audiorecord.1,v 1.3 1999/03/28 10:35:06 mrg Exp $
+.\"    $NetBSD: audiorecord.1,v 1.4 1999/03/30 14:48:49 mrg Exp $
 .\"
-.\" Copyright (c) 1998 Matthew R. Green
+.\" Copyright (c) 1998-1999 Matthew R. Green
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -26,7 +26,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd October 20, 1998
+.Dd March 30, 1999
 .Dt AUDIORECORD 1
 .Os NetBSD
 .Sh NAME
@@ -145,4 +145,14 @@
 .Sh SEE ALSO
 .Xr audioctl 1 ,
 .Xr audioplay 1 ,
-.Xr audio 4 .
+.Xr audioamd 4 ,
+.Xr aria 4 ,
+.Xr audio 4 ,
+.Xr eap 4 ,
+.Xr ess 4 ,
+.Xr gus 4 ,
+.Xr guspnp 4 ,
+.Xr sb 4 ,
+.Xr sv 4 ,
+.Xr wss 4 ,
+.Xr ym .