clarify/document requirement for doall