rose documentation: fix bad rose suite-run documentation

This fixes some bad and/or misleading text in the `rose suite-run` documentation.

@matthewrmshin, please review.