updated mode parameter docs