additional comments on code generator operation