add shebangs and docstrings, ticket #6