minor fixes, clarify doc