rose documentation: update following feedback
rose documentation: tidy
rose task-run: allow more "--path=[NAME=]GLOB".

Process "--path=[NAME=]GLOB" in "rose task-run" in additional to those in
"rose task-env".
rose documentation: fix FAM
rose task-run: fix documentation.
rose documentation: update cylc references
rose documentation: fix ROSE_TASK_LOG_ROOT
t/rose-rug-brief-tour: fix broken test.

Test broken after cylc/cylc#477. See also #678.
rose documentation: improve example format
Merge pull request #689 from benfitzpatrick/doc.suite-feedback

rose documentation: update following feedback
Merge pull request #690 from matthewrmshin/more.rose-task-run--path

rose task-run --path=[NAME=]GLOB revisit
Merge pull request #691 from matthewrmshin/fix.t/rose-rug-brief-tour

t/rose-rug-brief-tour: fix broken test.