copy generated sources to right place, some doc updates, some code cleanup