updated comment style;  removed singleton example;  added class examples with doc comments