[pulseaudio-discuss] [PATCH] doc: Fix typos in doxygen documentation of pulse/def.h

[Gabriel M. Beddingfield]

On 04/10/2013 09:10 AM, Peter Meerwald wrote:
> @@ -283,7 +283,7 @@ typedef enum pa_stream_flags {
>        * "classic" hardware device fragment-style playback model. If
>        * this option is set, the minreq value of the buffer metrics gets
>        * a new meaning: instead of just specifying that no requests
> -     * asking for less new data than this value will be made to the
> +     * asking for new data less than this value will be made to the
>        * client it will also guarantee that requests are generated as
>        * early as this limit is reached. This flag should only be set in
>        * very few situations where compatibility with a fragment-based

I think the original wording was a little better.  what about...

"... a new meaning: in addition to declaring that the server will always 
request at least 'minreq' bytes from the client, it will also guarantee 
that requests are generated as soon as possible after this threshold is 
reached. (I.e. it will behave similar to hardware period-size 
interrupts.) This flag should only be set..."

(Assuming that I've even understood this paragraph.  It's not worded 
very well.)

-gabriel