format comments in examples

using // style comments for everything except javadocs. using javadocs
to describe the example in general.