- clarify when 0 is returned
- explain that decode_audio3 has to be called multiple times when there
  are multiple frames in a single packet


git-svn-id: file:///var/local/repositories/ffmpeg/trunk@20215 9553f0bf-9b14-0410-a0b8-cfaf0461ba5b