tidy up examples, whitespace, comments
renaming of constructors
documentation