ENH: Clean and improve API call docstrings.
ENH: Clean and improve API call docstrings.

Cleaned up some style, but also added new parameter descriptions. Some previously
inaccurate entries for return values are corrected.

midasplatform/pydas,jcfr/pydas