some comment/doc tweaks