made most fields final where applicable.
made inner private classes without reference to parent class data static.
Code style consistency changes (whitespace, braces, annotations).
fixed missing warning suppresion annotation in Aspect.
lots of javadoc formatting more consistent
lots of documentation. added a few missing "throws" statemets.
documentation, formatting
Merge pull request #15 from lopho/cleanup-docu

Cleanup and documentation