docstring improvement

correcting somme docstrings, and adding docstrings where they are
missing.