# HG changeset patch
# User Ryan C. Gordon <icculus@icculus.org>
# Date 1183604020 0
# Node ID ea059917233cf66d82e0c8dd859468f6d18a76ce
# Parent  e905bb5d9bc38793365b92d386c701eb44552138
Added notes about audio callback behaviour.

diff -r e905bb5d9bc3 -r ea059917233c docs.html
--- a/docs.html	Thu Jul 05 02:44:54 2007 +0000
+++ b/docs.html	Thu Jul 05 02:53:40 2007 +0000
@@ -52,6 +52,10 @@
 <P>
 	Unofficial support for the Nintendo DS platform has been added.
 </P>
+<P>
+	Audio callbacks must now initialize the entire stream: applications must write silence to the stream if they can't supply data, and not mix against the buffer, as it may be random data.
+	Users may set SDL_AUDIO_MUST_INIT_BUFFERS to retain the old behaviour, but apps should not depend on this environment variable: just add a memset() at the start of your audio callback instead if you need it.
+</P>
 </BLOCKQUOTE>
 
 <H3> Unix Notes </H3>