Hi Solene, sorry if i misunderstand because i did not fully follow the thread...
Solene Rapenne wrote on Tue, Nov 17, 2020 at 07:36:38PM +0100: > I added the new variable after MIDIDEVICE in the ENVIRONMENT section > to keep order of appearance in the document. Usually, we order the ENVIRONMENT section alphabetically. Also, on first sight, the text of AUDIODEVICE and AUDIORECDEVICE seems to cause a contradiction. The earlier text below "Default Audio and MIDI devices" appears to resolve the apparent contradiction, but wouldn't it be better to give a complete definition at one place? For example similar to ths: .It Ev AUDIODEVICE Audio device descriptor to use for playback when no descriptor is explicitly specified to a program. It is also used for recording if .Ev AUDIORECDEVICE is unset. .It Ev AUDIORECDEVICE Audio device descriptor to use for recording when no descriptor is explicitly specified to a program. .It Ev MIDIDEVICE [... unchanged ...] And below "Default Audio and MIDI devices" something like: When no audio device descriptor is provided to a program or when the reserved word .Cm default is passed as the device descriptor, the program uses the one specified in the .Ev AUDIODEVICE environment variable for playback and the one specified in .Ev AUDIORECDEVICE for recording, falling back to .Ev AUDIODEVICE if the latter is unset. If the applicable variables are unset, the program first tries to connect to [...] Feel free to ignore me if i misunderstood or if you disagree, or to tweak the wording according to your taste. Yours, Ingo > Index: sndio.7 > =================================================================== > RCS file: /home/reposync/src/lib/libsndio/sndio.7,v > retrieving revision 1.24 > diff -u -p -r1.24 sndio.7 > --- sndio.7 18 Jul 2020 05:01:14 -0000 1.24 > +++ sndio.7 17 Nov 2020 18:32:34 -0000 > @@ -157,6 +157,10 @@ If it is not set, the program first trie > .Li snd/0 . > If that fails, it then tries to use > .Li rsnd/0 . > +The > +.Ev AUDIORECDEVICE > +environment variable > +defines a device to use prior to the audio device when recording. > .Pp > Similarly, if no MIDI descriptor is provided to a program > or when the reserved word > @@ -196,6 +200,9 @@ Audio device descriptor to use > when no descriptor is explicitly specified to a program. > .It Ev MIDIDEVICE > MIDI port descriptor to use > +when no descriptor is explicitly specified to a program. > +.It Ev AUDIORECDEVICE > +Audio recording device descriptor to use > when no descriptor is explicitly specified to a program. > .El > .Pp >
