fix egregious logic error in #all; clean up some code docs