Re: [AD] docs: play_audio_stream clarification

[Eric Botcazou <ebotcazou@xxxxxxxxxx>]

> Just was confused one too many times about how to count samples in
> play_audio_stream. The docs speak of alternating left/right - samples,
> yet one sentence before one sample means the complete pair. The new
> wording should be clear.

I agree that's confusing.

@@ -6646,7 +6646,8 @@
    you can use the regular voice_*() functions with stream-&gtvoice as a
    parameter. The sample data is always in unsigned format, with stereo
    waveforms consisting of alternating left/right samples, left sample
-   first.
+   first. The len parameter still counts one left/right pair as one sample
+   in that case.

Why not "with stereo waveforms consisting of samples made of left/right 
components, left component first.  The len parameter is always measured in 
samples, regardless of the internal sructure of these samples." ?

"Component" or any other better wording.

-- 
Eric Botcazou