minor fixes; added some usage info on docstrings