massive documentation tweaks. thanks G_will.