update ::run documentation