DDoc audio module third pass

Fixed some paragraphs. We're paying the price of some files being very
wide (due to some long documentation sentences) for the benefit of code
suggestions being more readable.