dispatcher: documentation clarifications