update of some comment blocks