On Fri Nov 27, 2020 at 3:05 PM -03, Alexandre Ratchov wrote: > this wording is shorter and more precise and complete. > > ok? > > Index: sio_open.3 > =================================================================== > RCS file: /cvs/src/lib/libsndio/sio_open.3,v > retrieving revision 1.51 > diff -u -p -r1.51 sio_open.3 > --- sio_open.3 20 Nov 2020 12:09:45 -0000 1.51 > +++ sio_open.3 27 Nov 2020 18:02:16 -0000 > @@ -387,17 +387,17 @@ bitmasks should always be used. > .Ss Starting and stopping the device > The > .Fn sio_start > -function puts the device in a waiting state: > -the device will wait for playback data to be provided > -(using the > -.Fn sio_write > -function). > -Once enough data is queued to ensure that play buffers > -will not underrun, actual playback is started automatically. > -If record mode only is selected, then recording starts > -immediately. > +function prepares the devices to start.
Using 'devices' instead of 'device' here is different from the current version. Is that intentional? > +Once the play buffer is full, i.e. > +.Fa sio_par.bufsz > +samples are queued with > +.Fn sio_write , > +playback starts automatically. > +If record mode only is selected, then > +.Fn sio_start > +starts recording immediately. > In full-duplex mode, playback and recording will start > -synchronously as soon as enough data to play is available. > +synchronously as soon as the play buffer is full. > .Pp > The > .Fn sio_stop Thanks for looking into this, it's much clearer now. Érico
