[pulseaudio-discuss] [PATCH] Documentation of known misuse of PulseAudio API

[Alexander E. Patrakov]

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