re-clarify/document requirement for doall :-/