"a" MIDI, not "an";

add missing HISTORY; based on CVS logs and release announcements

Move sndiod man page to section 8.

suggested by deraadt, fixes from jmc, ok millert

Remove useless quoting from .Fo and .Fn function names, to prevent
development of a cargo cult in case people look at existing files
for examples. This achieves a consistent .Fo and .Fn quoting style
across the whole tree.

say this is the "sndio" api, as we have other audio/midi apis,
makes "man -k" happier.

ok jmc, schwarze

remove FILES sections because it's incomplete, wrong and doesn't give
any useful information

use fancy .In macro for includes. from Jan Klemkow. ok jmc schwarze

explain what "default" means in sndio.7 rather than {sio,mio}_open.3,
with tweaks from jmc

Improve instructions for handling non-blocking I/O with poll(2) and
the mio_* functions. As per suggestion from jmc tidy up spacing in
RETURN VALUES section and Xr poll(2). ok jmc ratchov

Have mio_open(3) document all return values in the RETURN VALUES section.
And don't document the return value of mio_pollfd() twice, one instance
of which was incorrect. ok jmc, ratchov

Make the "default" string a valid device name that has the same effect
as NULL has. This will (hopefully) simplify ports where the user
passes the device string.

Use "unsigned int" rather than "unsigned". No object change.
suggested by deraadt@

mention sndiod rather than aucat when talking about the server

Remove midicat since aucat can now be used instead of midicat
with almost the same syntax (roughly an extra -M option).
Thru boxes are created with aucat, and corresponding MIDI port
names have the "aucat" prefix instead of "midithru". The old
device name will still work some time for backward compatibility.

ok deraadt

Make aucat audio and midi backends share the same code to communicate
with the server. As we're at it use the same protocol for midi and
audio. Now, both audio and midi code use the same SNDIO_DEBUG environment
variable to turn on/off DPRINTF's.

rephrase description of (MIO_IN | MIO_OUT) mode
from Thomas Pfaff, ok jmc@

use const qualifier in libsndio, making it slightly more consistent
with open(2) and write(2) syscalls.
from Thomas Pfaff, jakemsr is fine with it

Currently midi capable programs can control midi hardware, but
cannot cooperate with other programs. The aim of this change is
to allow any program to send midi data to other programs as they
were midi hardware. For instance, this change should solve the
longstanding problem of using a midi sequencer with software
synthesizers. More precisely:

- new midicat(1) utility (actually hardlink to aucat(1)).
it creates software midi thru boxes, allowing programs
to send midi messages to other programs as they were
midi(4) hardware.

- new midi api in libsndio (see mio_open(3)), to access
midi(4) devices and midicat(1) sockets in a uniform way.

- new device naming scheme <service>:<unit>[.<option>],
common to audio and midi.

- new sndio(7) manual describing concepts and naming

The current audio device naming still works, but people having
scripts or configuration files containing device names could read
the sndio(7) man page and slowly start updating device names.

discussed with jakemsr@ and deraadt@, help form jmc@

add missing HISTORY; based on CVS logs and release announcements

Move sndiod man page to section 8.

suggested by deraadt, fixes from jmc, ok millert

Remove useless quoting from .Fo and .Fn function names, to prevent
development of a cargo cult in case people look at existing files
for examples. This achieves a consistent .Fo and .Fn quoting style
across the whole tree.

say this is the "sndio" api, as we have other audio/midi apis,
makes "man -k" happier.

ok jmc, schwarze

remove FILES sections because it's incomplete, wrong and doesn't give
any useful information

use fancy .In macro for includes. from Jan Klemkow. ok jmc schwarze

explain what "default" means in sndio.7 rather than {sio,mio}_open.3,
with tweaks from jmc

Improve instructions for handling non-blocking I/O with poll(2) and
the mio_* functions. As per suggestion from jmc tidy up spacing in
RETURN VALUES section and Xr poll(2). ok jmc ratchov

Have mio_open(3) document all return values in the RETURN VALUES section.
And don't document the return value of mio_pollfd() twice, one instance
of which was incorrect. ok jmc, ratchov

Make the "default" string a valid device name that has the same effect
as NULL has. This will (hopefully) simplify ports where the user
passes the device string.

Use "unsigned int" rather than "unsigned". No object change.
suggested by deraadt@

mention sndiod rather than aucat when talking about the server

Remove midicat since aucat can now be used instead of midicat
with almost the same syntax (roughly an extra -M option).
Thru boxes are created with aucat, and corresponding MIDI port
names have the "aucat" prefix instead of "midithru". The old
device name will still work some time for backward compatibility.

ok deraadt

Make aucat audio and midi backends share the same code to communicate
with the server. As we're at it use the same protocol for midi and
audio. Now, both audio and midi code use the same SNDIO_DEBUG environment
variable to turn on/off DPRINTF's.

rephrase description of (MIO_IN | MIO_OUT) mode
from Thomas Pfaff, ok jmc@

use const qualifier in libsndio, making it slightly more consistent
with open(2) and write(2) syscalls.
from Thomas Pfaff, jakemsr is fine with it

Currently midi capable programs can control midi hardware, but
cannot cooperate with other programs. The aim of this change is
to allow any program to send midi data to other programs as they
were midi hardware. For instance, this change should solve the
longstanding problem of using a midi sequencer with software
synthesizers. More precisely:

- new midicat(1) utility (actually hardlink to aucat(1)).
it creates software midi thru boxes, allowing programs
to send midi messages to other programs as they were
midi(4) hardware.

- new midi api in libsndio (see mio_open(3)), to access
midi(4) devices and midicat(1) sockets in a uniform way.

- new device naming scheme <service>:<unit>[.<option>],
common to audio and midi.

- new sndio(7) manual describing concepts and naming

The current audio device naming still works, but people having
scripts or configuration files containing device names could read
the sndio(7) man page and slowly start updating device names.

discussed with jakemsr@ and deraadt@, help form jmc@