various notes and improvements
work on sec. 4
ignore some more gen. files