Also ignore .pyc files, because annoying.
Restructure documentation, to have the source and tools in doc/ subdirectory.

This helps keep the root of the repo cleaner and (hopefully) less scary.
Removed trace printout.

D'oh!
Respect paragraph boundaries in the function documentation.