closes #22 better documentation for updatingControls flag