Lots of comments in here also. I would probably move them to a file in doc/ that explains what they do or when you would want to use them.