From 2e69a8f5504aba693f5b3de79a32f671fee9b764 Mon Sep 17 00:00:00 2001
From: "Ryan C. Gordon" <icculus@icculus.org>
Date: Thu, 5 Jul 2007 02:53:40 +0000
Subject: [PATCH] Added notes about audio callback behaviour.

--HG--
branch : SDL-1.2
extra : convert_revision : svn%3Ac70aab31-4412-0410-b14c-859654838e24/branches/SDL-1.2%402416
---
 docs.html | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs.html b/docs.html
index 5deb10373..25cb6fd9f 100644
--- a/docs.html
+++ b/docs.html
@@ -52,6 +52,10 @@ SDL 1.2.12 is a minor bug fix release.
 <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>