Add ALL the comments!!

Moved the comments to the public header files, and added in any missing comments. Using AppleDoc style for compatability with CocoaDocs.