Merge changes Ifd7ec3dc,Ia28c9217

* changes:
  audio: Clarify documentation for some methods
  audio: Provide documentation for enums in 'common' package