added some documentation for globals, constructors, etc.