more docs and random code tweaks. nothing much here.