On Sun, Jun 24, 2018 at 06:26:02PM +0200, Alexandre Ratchov wrote:
> On Sun, Jun 24, 2018 at 05:38:11PM +0200, Landry Breuil wrote:
> > On Sun, Jun 24, 2018 at 05:23:46PM +0200, Landry Breuil wrote:
> > > Hi,
> > > 
> > > here's an attempt at documenting the usecase i always forget when
> > > playing with multiple devices/mics. Feedback/reworking/tweaks welcome.
> > 
> > New version after super quick feedback from jmc@, unsure where to put
> > the comma around 'for example' though.
> > 
> > Landry
> > 
> > Index: sndiod.8
> > ===================================================================
> > RCS file: /cvs/src/usr.bin/sndiod/sndiod.8,v
> > retrieving revision 1.2
> > diff -u -r1.2 sndiod.8
> > --- sndiod.8    18 Jan 2016 11:38:07 -0000      1.2
> > +++ sndiod.8    24 Jun 2018 15:37:17 -0000
> > @@ -484,6 +484,17 @@
> >  Regardless of which device a stream is connected to,
> >  its playback volume knob is exposed.
> >  .Sh EXAMPLES
> > +Start server at boot using two devices, for example
> > +.Xr audio 4
> > +device on
> > +.Pa snd/0
> > +and an external
> > +.Xr uaudio 4
> > +microphone on
> > +.Pa snd/1 :
> > +.Pp
> > +.Dl # rcctl set sndiod flags '-frsnd/0 -frsnd/1'
> > +.Pp
> >  Start server using default parameters, creating an
> >  additional sub-device for output to channels 2:3 only (rear speakers
> >  on most cards), exposing the
> > 
> 
> I've two remarks: 
> 
> - I'd prefer we make this example look like the other examples,
>   without refence to rcctl. I think people can figure out by
>   themselves how to transpose this to rcctl.

Normal joe user rarely starts sndiod manually... this particular example
allows one to copy/paste it in a term and be done with it forever :)

> - The exemple is valid for any devices, not only uaudio
>   one. Furthermore refs to audio(4) may raise the question "should I
>   use device paths like /dev/audio as specified in audio(4)"? The rest
>   of the manual uses "sndio audio device" or just "audio device".

how about 'for example the internal audio device and an external usb
microphone device' without any specific markup/link ?

Reply via email to