fix typos, thanks carl and bruce
more cleanups and more text
minor