Notes and stuff

As requested, I went to town on your scripts. Each commit has a little justification, and I tried to keep the changes as atomic as possible.

Enjoy!