Remove duplicate parameter documentation
Use short form of function/method/class links
Change argument order

The arguments which are forwarded to the SoundFile constructor, are
moved to the back (because they are very seldomly used).

See also #78.
Create docstrings for underscore-prefixed functions
Changes to most of the docstrings