Re-do javadocs per @swankjesse 's brilliant suggestion that makes EVERYTHING look cleaner in the generator code.