add a bunch of random notes and fix some issues noticed by Gabor.

This is not ready for review or hacking, this is a work in progress :)

llvm-svn: 46816