cleanups and fixes in comments/docs mostly