cleanup for pull request - part 1. includes crlf->lf fixes
cleanup for pull request, better documentation