detailed comment on generator functions
fold code
Cleanup generated file on build fails
move generated code to ./gen insteadof ./lib