clarified comments
various code/docs cleanup