fix up doc for run()