move bufsz description after appbufsz as per struct fields order

ok ratchov@

Tweak to clarify sio_stop(3) and sio_flush() description, from jmc@

Add sio_flush(3) function to stop playback immediately

The new sio_flush(3) functions works the same way as sio_stop(3),
except that it doesn't wait for play buffer to be drained. Instead,
it discar

Add sio_flush(3) function to stop playback immediately

The new sio_flush(3) functions works the same way as sio_stop(3),
except that it doesn't wait for play buffer to be drained. Instead,
it discards its contents and returns immediately.

show more ...

man pages: add missing commas between subordinate and main clauses

jmc@ dislikes a comma before "then" in a conditional, so leave those
untouched.

ok jmc@

Clarify what sio_start() does exactly

Suggested by Erico Nogueira <ericonr@disroot.org>,
help from and ok jmc@, schwarze@

* Add SIO_BPS() to NAME and SYNOPSIS where it is missing.
* Use .Fn rather than .Dv for macros taking arguments.
* Actually say what SIO_LE_NATIVE means.
* Add closely related APIs to SEE ALSO.
* Add

* Add SIO_BPS() to NAME and SYNOPSIS where it is missing.
* Use .Fn rather than .Dv for macros taking arguments.
* Actually say what SIO_LE_NATIVE means.
* Add closely related APIs to SEE ALSO.
* Add missing HISTORY and AUTHORS sections.
OK ratchov@

show more ...

basic macro cleanup: .Fo for long .Fn lines, .Fa for struct fields,
avoid \*(Gt and \*(Lt, .Dv NULL, .Cm for pledge promises

move mixerctl and audioctl man pages to section 8, as these work
against root-only device nodes.

Sayt that using capabilities to negociate audio parameters (ie using
sio_getcap() function) is not recomended.

From Paul Swanson <psw at protonmail.com>, ok jmc

Move libsndio session cookie in its own $HOME/.sndio/ directory to
make libsndio easier to use with unveil(2).

"make sense" deraadt

Tweak RETURN VALUES section. Move description of sio_pollfd() and
sio_nfds() return values there and add a paragraph about sio_eof().

ok jmc ratchov

Document how to use sndio in pledged programs.

Input and OK jmc@ ratchov@ semarie@

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 styl

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.

show more ...

Kill the only instance of .Lb in our tree. It is better to not use
it at all, not even occasionally, because there is no sustainable
way (and even less any portable way) to maintain the list of libr

Kill the only instance of .Lb in our tree. It is better to not use
it at all, not even occasionally, because there is no sustainable
way (and even less any portable way) to maintain the list of library
names. Besides, without such a list, even the formatting looks bad.
OK jmc@ bentley@

show more ...

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

ok jmc, schwarze

clean up macro usage;
tweak and ok ratchov@, ok jmc@

- clarify that sio_close() stops the device first, then
frees the handle and not the opposite
- clarify that sio_close() and sio_stop() dont discard
samples in the play buffer.

suggested by Reim

- clarify that sio_close() stops the device first, then
frees the handle and not the opposite
- clarify that sio_close() and sio_stop() dont discard
samples in the play buffer.

suggested by Reimar Doeffinger <Reimar.Doeffinger at gmx.de>

ok jmc@

show more ...

- replaces "audio stream" by "audio device", as sndio is a device
abstraction
- remove useless statements.

ok jmc@

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

shorten lines in literal blocks to avoid word wraping

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

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@