Reformat and refine doco and examples. Examples were known names