Edited function docstrings to follow conventions

Docstring conventions:
https://www.python.org/dev/peps/pep-0257/#handling-docstring-indentation

Note these are guidelines, not rules -- fine to do something else if you
really prefer. The link above contains info for multi-line docstrings as
well (but this file only needed one-lines). Another style guide from
Google:

https://google-styleguide.googlecode.com/svn/trunk/pyguide.html

I also added #----- lines in between function definitions to make the
file more readable. This is a Kayla convention, not a popular
convention.
Revert "Added crucial comment about kayla koolness"

This reverts commit 577743f426ce4ecc28990eed5cc643aa8ecdcc4a.
Revert "Edited function docstrings to follow conventions"

This reverts commit 927395a03b54555cdd917035242ed65021731b52.
Added Python shebang

Added Python shebang (this should always be the very top line of any
Python file, before anything else. It prevents potential problems with
the Python interpreter, though scripts theoretically sometimes run OK
without it):

http://stackoverflow.com/questions/2429511/why-do-people-write-usr-bin-env-python-on-the-first-line-of-a-python-script

For some reason Git thinks that I also deleted whitespace in this
commit; I didn't intentionally, must be some editor thing.  Shouldn't
affect code.
Revert "Revert "Edited function docstrings to follow conventions""

This reverts commit c72b9bdd28ab23cdecca9811f613d5726aae0b04.
Edited overall module docstring + fixed some other comments previously missed