diff -r 89e065397ea6 -r e24348a560a6 src/multimedia/audio/qaudioinput.cpp
--- a/src/multimedia/audio/qaudioinput.cpp	Thu May 27 13:40:48 2010 +0300
+++ b/src/multimedia/audio/qaudioinput.cpp	Fri Jun 11 14:24:45 2010 +0300
@@ -211,6 +211,10 @@
      If a problem occurs during this process the error() is set to QAudio::OpenError,
      state() is set to QAudio::StoppedState and stateChanged() signal is emitted.
 
+    In either case, the stateChanged() signal may be emitted either synchronously
+    during execution of the start() function or asynchronously after start() has
+    returned to the caller.
+
      \sa {Symbian Platform Security Requirements}
 
      \sa QIODevice
@@ -233,6 +237,10 @@
     If a problem occurs during this process the error() is set to QAudio::OpenError,
     state() is set to QAudio::StoppedState and stateChanged() signal is emitted.
 
+    In either case, the stateChanged() signal may be emitted either synchronously
+    during execution of the start() function or asynchronously after start() has
+    returned to the caller.
+
     \sa {Symbian Platform Security Requirements}
 
     \sa QIODevice
@@ -278,6 +286,8 @@
 
     Sets error() to QAudio::NoError, state() to QAudio::SuspendedState and
     emit stateChanged() signal.
+
+    Note: signal will always be emitted during execution of the resume() function.
 */
 
 void QAudioInput::suspend()
@@ -300,7 +310,7 @@
 }
 
 /*!
-    Sets the audio buffer size to \a value milliseconds.
+    Sets the audio buffer size to \a value bytes.
 
     Note: This function can be called anytime before start(), calls to this
     are ignored after start(). It should not be assumed that the buffer size
@@ -315,7 +325,7 @@
 }
 
 /*!
-    Returns the audio buffer size in milliseconds.
+    Returns the audio buffer size in bytes.
 
     If called before start(), returns platform default value.
     If called before start() but setBufferSize() was called prior, returns value set by setBufferSize().