Man page changes for the midi integration

3 files changed, 188 insertions, 3 deletions

diff --git a/share/man/man4/man4.i386/speaker.4 b/share/man/man4/man4.i386/speaker.4
index 505f1c4c029..cd268b45b37 100644
--- a/share/man/man4/man4.i386/speaker.4
+++ b/share/man/man4/man4.i386/speaker.4
@@ -1,4 +1,5 @@
-.\"	$OpenBSD: speaker.4,v 1.5 1998/09/01 16:38:22 deraadt Exp $
+.\"	$OpenBSD: speaker.4,v 1.6 1999/01/07 22:32:58 niklas Exp $
+.\"	$NetBSD: speaker.4,v 1.9 1998/08/18 08:16:56 augustss Exp $
 .\"
 .\" Copyright (c) 1993 Christopher G. Demetriou
 .\" All rights reserved.
@@ -34,7 +35,7 @@
 .Sh NAME
 speaker \- console speaker device driver
 .Sh SYNOPSIS
-.Cd "spkr0	at pckbd? port 0x61"
+.Cd "spkr0	at pcppi?"
 .Fd #include <machine/spkr.h>
 .Pa /dev/speaker
 .Sh DESCRIPTION
@@ -95,7 +96,7 @@ locking is disabled for one letter note following by >, < and O[0123456].
 < -- drop the current octave down one.
 .Pp
 N <n> -- play note n, n being 1 to 84 or 0 for a rest of current time value.
-May be followed by sustain dots.
+May be followedv by sustain dots.
 .Pp
 L <n> -- sets the current time value for notes. The default is L4, quarter
 notes. The lowest possible value is 1; values up to 64 are accepted. L1 sets
@@ -151,5 +152,7 @@ to crossing a block boundary.
 .Bl -tag -width Pa -compact
 .It Pa /dev/speaker
 .El
+.\" .Sh SEE ALSO
+.\" .Xr pcppi 4 .
 .Sh AUTHOR
 Eric S. Raymond (esr@snark.thyrsus.com) Feb 1990
diff --git a/share/man/man4/midi.4 b/share/man/man4/midi.4
new file mode 100644
index 00000000000..7369a5aa217
--- /dev/null
+++ b/share/man/man4/midi.4
@@ -0,0 +1,112 @@
+.\" $OpenBSD: midi.4,v 1.1 1999/01/07 22:32:57 niklas Exp $
+.\" $NetBSD: midi.4,v 1.4 1998/08/22 14:45:35 augustss Exp $
+.\" Copyright (c) 1997 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"        This product includes software developed by the NetBSD
+.\"        Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd August 6, 1998
+.Dt MIDI 4
+.Os
+.Sh NAME
+.Nm midi
+.Nd device-independent MIDI driver layer
+.Sh SYNOPSIS
+.Cd "midi* at opl?"
+.Cd "midi* at pcppi?"
+.Cd "midi* at sb?"
+.Cd "midi* at wss?"
+.Cd "pseudo-device sequencer"
+.Pp
+.Fd #include <sys/types.h>
+.Fd #include <sys/midiio.h>
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for various MIDI peripherals.
+It provides a uniform programming interface layer above different
+underlying MIDI hardware drivers.  The MIDI hardware can be of many
+different kinds, e.g., an external synthesizer on a MIDI port (or a serial port),
+the PC speaker, an internal FM synth, or a wavetable synth.
+.Pp
+There are two device file types available for MIDI operation:
+.Pa /dev/rmidiN ,
+and
+.Pa /dev/music .
+The
+.Pa /dev/rmidiN
+devices provides raw access to a MIDI device.  Data written is sent
+to the physical device as fast as possible and is uninterpreted.
+Reading from the device returns data as soon as it becomes available.
+A moderate amount of buffering is available both for reading and writing.
+The raw MIDI devices are mostly useful for non realtime operations, such as
+downloading patches to a device, since it is hard to get the accurate timing
+needed for quality music from a user program.  But the devices can act as
+a simple patchboard for MIDI devices.  For example, a MIDI keyboard could
+be connected to a synthesizer by the command
+.Cd "cat -u /dev/rmidi1 >/dev/rmidi2"
+.Pp
+The 
+.Pa /dev/music
+device is a MIDI sequencer device.  Data sent to and from this device
+not only contains the information sent to the MIDI device, but also
+timing information.  The kernel will make sure that data is sent
+to the physical device at the indicated time.  The sequencer device
+uses the 
+.Pa /dev/midiN
+devices internally and they are unavailable when used by the sequencer.
+.Pp
+The API for the sequencer device is binary compatible with the OSS sequencer
+interface.
+.Sh FILES
+.Bl -tag -width /dev/sequencer -compact
+.It Pa /dev/rmidiN
+.It Pa /dev/music
+.It Pa /dev/sequencer
+.El
+.Sh SEE ALSO
+.Xr audio 4 ,
+.Xr ioctl 2 ,
+.Xr midiplay 1 ,
+.Xr opl 4 ,
+.Xr ossaudio 3 .
+.br
+For ports using the ISA bus:
+.\" .Xr pcppi 4 ,
+.Xr sb 4 ,
+.Xr wss 4 .
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Nx 1.4 .
+.Sh BUGS
+This man page is very incomplete.
+.Pp
diff --git a/share/man/man4/opl.4 b/share/man/man4/opl.4
new file mode 100644
index 00000000000..6437aee5dd7
--- /dev/null
+++ b/share/man/man4/opl.4
@@ -0,0 +1,70 @@
+.\" $OpenBSD: opl.4,v 1.1 1999/01/07 22:32:57 niklas Exp $
+.\" $NetBSD: opl.4,v 1.3 1998/09/08 11:59:48 augustss Exp $
+.\" Copyright (c) 1997 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"        This product includes software developed by the NetBSD
+.\"        Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd August 18, 1998
+.Dt OPL 4
+.Os
+.Sh NAME
+.Nm opl
+.Nd Yamaha OPL2 and OPL3 FM syntheziser driver
+.Sh SYNOPSIS
+.Cd "opl*  at ess?"
+.Cd "opl0  at isa? port 0x388"
+.Cd "opl*  at sb?"
+.Cd "opl*  at wss?"
+.Cd "midi* at opl?"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for the Yamaha OPL2 (YM3812) and OPL3
+(YMF262) chips.  The chips are FM synthezisers and are capable
+of producing a wide range of (mostly awful) sounds.
+.Pp
+Access to the device is through the MIDI driver.
+.Pp
+The
+.Nm
+driver usually attaches to a sound card, but it can also sit
+directly on the ISA bus.
+.Sh SEE ALSO
+.Xr ess 4 ,
+.Xr isa 4 ,
+.Xr midi 4 ,
+.Xr sb 4 ,
+.Xr wss 4
+.Sh HISTORY
+The
+.Nm
+device driver first appeared in
+.Nx 1.4 .