Raymond Yau wrote: > Over time, I became aware of several instances of tempting but > > > semantically incorrect usage of PulseAudio API (one from my own bad > > proposal of "improving" Wine, one from Parole media player and one > > from Webkit-GTK). I want to document these gotchas so that other > > developers don't fall for that. See the attached patch. > > > > I have checked that the rendered HTML is correct, but need someone to > > confirm the factual accuracy of the proposed changes and, possibly, to > > improve the wording. > > Do you mean the values in > http://cgit.freedesktop.org/pulseaudio/pulseaudio/plain/src/tests/volume-tes > t.c are incorrect ? No. I meant that my changes might contradict some observable pulseaudio behaviour. E.g. my changes would be wrong if pa_context_get_sink_info_by_name() did not exist or was not passing the PA_SINK_FLAT_VOLUME information to the callback. -- Alexander E. Patrakov