several ws tweaks to the generated code; added dartdoc for return types