update usage, deprecate run in docs