{"action":"created","comment":{"url":"https://api.github.com/repos/metomi/rose/pulls/comments/29496248","id":29496248,"diff_hunk":"@@ -362,41 +362,80 @@ <h2 id=\"rose-task-run.built-in-app.fcm_make\">Built-in Application:\n     <p>The <code>fcm_make</code> built-in applications is provided for running\n     <code>fcm make</code>.</p>\n \n-    <p>N.B. If a task has a name that starts with <var>fcm_make*</var>,\n-    <code>rose task-run</code> will run this built-in application.</p>\n-\n-    <p>N.B. If a task has a name that starts with <var>fcm_make2*</var> and it\n-    does not have its own application configuration, <code>rose task-run</code>\n-    will attempt to associate it with the corresponding <var>fcm_make*</var>\n-    application configuration.</p>\n+    <p>N.B.:</p>\n+    \n+    <ul>\n+      <li>If a task has a name that contains the string <var>fcm_make</var>,\n+      <code>rose task-run</code> will run this built-in application\n+      automatically.</li>\n+\n+      <li>N.B. If a task has a name that contains the string\n+      <var>fcm_make2*</var> and it does not have its own application\n+      configuration, <code>rose task-run</code> will attempt to associate it\n+      with the corresponding <var>fcm_make*</var> application\n+      configuration.</li>\n+\n+      <li>In the default setting, the <samp>bin/</samp> directories of builds\n+      will be prepended to the <var>PATH</var> environment variable by\n+      <code>rose task-env</code> and/or <code>rose task-run</code> commands run\n+      by subsequent tasks in the suite.</li>\n+    </ul>\n \n     <p>The <code>fcm_make</code> application expects a file\n     <var>file/fcm-make.cfg</var> in its application configuration. It runs\n     <code>fcm make</code> using this configuration file.</p>\n \n-    <p>The <code>fcm make</code> application will also look for a matching\n-    <code>fcm_make2*</code> task in the suite which would normally be a\n-    continuation of the <code>fcm make</code> command as a separate\n-    <var>USER@HOST</var>. If so, will export an environment variable\n-    <var>ROSE_TASK_MIRROR_TARGET</var> to the <code>fcm make</code> command to\n-    substitute the mirror target.</p>\n-\n     <p>You can configure these applications with environment variables or\n     settings in <var>rose-app.conf</var>. (Settings in <var>rose-app.conf</var>\n     override their equivalent environment variables.)</p>\n \n-    <p><kbd>use-pwd=true</kbd>: By default, the application changes the working\n-    directory to <var>$ROSE_SUITE_DIR/share/$ROSE_TASK_NAME</var>. This option\n-    will stop this, and the working directory is the normal working directory\n-    of the task.</p>\n+    <dl>\n+      <dt><kbd>args=ARG ...</kbd> or the environment variable\n+      <var>ROSE_TASK_OPTIONS</var></dt>\n+\n+      <dd>This can be used to pass extra arguments to the <code>fcm make</code>\n+      command.</dd>\n+\n+      <dt><kbd>opt.jobs=N</kbd> or the environment variable\n+      <var>ROSE_TASK_N_JOBS</var></dt>\n+\n+      <dd>This can be used to control the number of processes <code>fcm\n+      make</code> would use in parallel. (default=4)</dd>\n \n-    <p><kbd>opt.jobs=N</kbd> or the environment variable\n-    <var>ROSE_TASK_N_JOBS</var>: This can be used to control the number of\n-    processes <code>fcm make</code> would use in parallel. (default=4)</p>\n+      <dt><kbd>make-name-cont=NAME</kbd></dt>\n \n-    <p><kbd>args</kbd> or the environment variable\n-    <var>ROSE_TASK_OPTIONS</var>: This can be used to pass extra arguments to\n-    the <code>fcm make</code> command.</p>\n+      <dd>Specify the context name of the continuation make. If the default\n+      <code>fcm_make</code> &rarr; <code>fcm_make2</code> mapping is used, the\n+      context name of the continuation make will be set to <code>2</code>. You\n+      can specify an alternate context name if this is undesirable. The\n+      continuation command will be invoked with the <code>--name=NAME</code>\n+      option of <code>fcm make</code>.</dd>\n+\n+      <dt><kbd>mirror-step=STEP-NAME</kbd></dt>\n+\n+      <dd>Specify the name of the mirror step, if not <samp>mirror</samp>. The\n+      application will normally look for a matching task in the suite (e.g.\n+      <code>fcm_make</code> &rarr; <code>fcm_make2</code>) which will continue\n+      the <code>fcm make</code> command at a remote <var>HOST</var>. If such a\n+      task is found, it will add the configuration\n+      <var>mirror.target=HOST:cylc-run/$ROSE_SUITE_NAME/share/$ROSE_TASK_NAME</var>\n+      as an argument to the <code>fcm make</code> command to substitute the\n+      mirror target. To switch off this feature, set <var>STEP-NAME</var> to a\n+      null string, i.e. <kbd>mirror-step=</kbd>.</dd>\n+\n+      <dt><kbd>task-name-orig2cont=ORIG-NAME:CONT-NAME</kbd></dt>","path":"doc/rose-rug-task-run.html","position":89,"original_position":89,"commit_id":"52d4af3e178c1919cbc6284efe2372ebab1f863d","original_commit_id":"61bc8f8f92062c5389ea6cd6e4ae9db3e0fbc511","user":{"login":"benfitzpatrick","id":1138333,"avatar_url":"https://avatars.githubusercontent.com/u/1138333?v=3","gravatar_id":"","url":"https://api.github.com/users/benfitzpatrick","html_url":"https://github.com/benfitzpatrick","followers_url":"https://api.github.com/users/benfitzpatrick/followers","following_url":"https://api.github.com/users/benfitzpatrick/following{/other_user}","gists_url":"https://api.github.com/users/benfitzpatrick/gists{/gist_id}","starred_url":"https://api.github.com/users/benfitzpatrick/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/benfitzpatrick/subscriptions","organizations_url":"https://api.github.com/users/benfitzpatrick/orgs","repos_url":"https://api.github.com/users/benfitzpatrick/repos","events_url":"https://api.github.com/users/benfitzpatrick/events{/privacy}","received_events_url":"https://api.github.com/users/benfitzpatrick/received_events","type":"User","site_admin":false},"body":"`names-orig-cont`, comma separated? It's not strictly a task name after all (often just part of a task name)","created_at":"2015-05-01T10:19:40Z","updated_at":"2015-05-01T10:19:40Z","html_url":"https://github.com/metomi/rose/pull/1604#discussion_r29496248","pull_request_url":"https://api.github.com/repos/metomi/rose/pulls/1604","_links":{"self":{"href":"https://api.github.com/repos/metomi/rose/pulls/comments/29496248"},"html":{"href":"https://github.com/metomi/rose/pull/1604#discussion_r29496248"},"pull_request":{"href":"https://api.github.com/repos/metomi/rose/pulls/1604"}}},"pull_request":{"url":"https://api.github.com/repos/metomi/rose/pulls/1604","id":34180368,"html_url":"https://github.com/metomi/rose/pull/1604","diff_url":"https://github.com/metomi/rose/pull/1604.diff","patch_url":"https://github.com/metomi/rose/pull/1604.patch","issue_url":"https://api.github.com/repos/metomi/rose/issues/1604","number":1604,"state":"open","locked":false,"title":"fcm make 2: improve support","user":{"login":"matthewrmshin","id":908613,"avatar_url":"https://avatars.githubusercontent.com/u/908613?v=3","gravatar_id":"","url":"https://api.github.com/users/matthewrmshin","html_url":"https://github.com/matthewrmshin","followers_url":"https://api.github.com/users/matthewrmshin/followers","following_url":"https://api.github.com/users/matthewrmshin/following{/other_user}","gists_url":"https://api.github.com/users/matthewrmshin/gists{/gist_id}","starred_url":"https://api.github.com/users/matthewrmshin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/matthewrmshin/subscriptions","organizations_url":"https://api.github.com/users/matthewrmshin/orgs","repos_url":"https://api.github.com/users/matthewrmshin/repos","events_url":"https://api.github.com/users/matthewrmshin/events{/privacy}","received_events_url":"https://api.github.com/users/matthewrmshin/received_events","type":"User","site_admin":false},"body":"Add `mirror.target=` to `fcm make` argument list as extra configuration, instead of relying on environment variables. This should work as long as we are on FCM 2014-03 or above.\r\n\r\nUse `-n 2` option of `fcm make` where relevant - this allows the continuation make to be in the same physical location.\r\n\r\nNew functionality dependent on metomi/fcm#188, but change should otherwise be backward compatible.","created_at":"2015-04-27T15:31:15Z","updated_at":"2015-05-01T10:19:40Z","closed_at":null,"merged_at":null,"merge_commit_sha":"fb5670e4638ad3f74eafa224ee8a0e2f3916072b","assignee":{"login":"benfitzpatrick","id":1138333,"avatar_url":"https://avatars.githubusercontent.com/u/1138333?v=3","gravatar_id":"","url":"https://api.github.com/users/benfitzpatrick","html_url":"https://github.com/benfitzpatrick","followers_url":"https://api.github.com/users/benfitzpatrick/followers","following_url":"https://api.github.com/users/benfitzpatrick/following{/other_user}","gists_url":"https://api.github.com/users/benfitzpatrick/gists{/gist_id}","starred_url":"https://api.github.com/users/benfitzpatrick/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/benfitzpatrick/subscriptions","organizations_url":"https://api.github.com/users/benfitzpatrick/orgs","repos_url":"https://api.github.com/users/benfitzpatrick/repos","events_url":"https://api.github.com/users/benfitzpatrick/events{/privacy}","received_events_url":"https://api.github.com/users/benfitzpatrick/received_events","type":"User","site_admin":false},"milestone":{"url":"https://api.github.com/repos/metomi/rose/milestones/32","html_url":"https://github.com/metomi/rose/milestones/next-release","labels_url":"https://api.github.com/repos/metomi/rose/milestones/32/labels","id":1087092,"number":32,"title":"next-release","description":"Rose release 27.","creator":{"login":"matthewrmshin","id":908613,"avatar_url":"https://avatars.githubusercontent.com/u/908613?v=3","gravatar_id":"","url":"https://api.github.com/users/matthewrmshin","html_url":"https://github.com/matthewrmshin","followers_url":"https://api.github.com/users/matthewrmshin/followers","following_url":"https://api.github.com/users/matthewrmshin/following{/other_user}","gists_url":"https://api.github.com/users/matthewrmshin/gists{/gist_id}","starred_url":"https://api.github.com/users/matthewrmshin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/matthewrmshin/subscriptions","organizations_url":"https://api.github.com/users/matthewrmshin/orgs","repos_url":"https://api.github.com/users/matthewrmshin/repos","events_url":"https://api.github.com/users/matthewrmshin/events{/privacy}","received_events_url":"https://api.github.com/users/matthewrmshin/received_events","type":"User","site_admin":false},"open_issues":3,"closed_issues":2,"state":"open","created_at":"2015-04-28T09:21:27Z","updated_at":"2015-04-29T14:18:15Z","due_on":"2015-05-28T23:00:00Z","closed_at":null},"commits_url":"https://api.github.com/repos/metomi/rose/pulls/1604/commits","review_comments_url":"https://api.github.com/repos/metomi/rose/pulls/1604/comments","review_comment_url":"https://api.github.com/repos/metomi/rose/pulls/comments{/number}","comments_url":"https://api.github.com/repos/metomi/rose/issues/1604/comments","statuses_url":"https://api.github.com/repos/metomi/rose/statuses/52d4af3e178c1919cbc6284efe2372ebab1f863d","head":{"label":"matthewrmshin:fcm_make2","ref":"fcm_make2","sha":"52d4af3e178c1919cbc6284efe2372ebab1f863d","user":{"login":"matthewrmshin","id":908613,"avatar_url":"https://avatars.githubusercontent.com/u/908613?v=3","gravatar_id":"","url":"https://api.github.com/users/matthewrmshin","html_url":"https://github.com/matthewrmshin","followers_url":"https://api.github.com/users/matthewrmshin/followers","following_url":"https://api.github.com/users/matthewrmshin/following{/other_user}","gists_url":"https://api.github.com/users/matthewrmshin/gists{/gist_id}","starred_url":"https://api.github.com/users/matthewrmshin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/matthewrmshin/subscriptions","organizations_url":"https://api.github.com/users/matthewrmshin/orgs","repos_url":"https://api.github.com/users/matthewrmshin/repos","events_url":"https://api.github.com/users/matthewrmshin/events{/privacy}","received_events_url":"https://api.github.com/users/matthewrmshin/received_events","type":"User","site_admin":false},"repo":{"id":6224216,"name":"rose","full_name":"matthewrmshin/rose","owner":{"login":"matthewrmshin","id":908613,"avatar_url":"https://avatars.githubusercontent.com/u/908613?v=3","gravatar_id":"","url":"https://api.github.com/users/matthewrmshin","html_url":"https://github.com/matthewrmshin","followers_url":"https://api.github.com/users/matthewrmshin/followers","following_url":"https://api.github.com/users/matthewrmshin/following{/other_user}","gists_url":"https://api.github.com/users/matthewrmshin/gists{/gist_id}","starred_url":"https://api.github.com/users/matthewrmshin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/matthewrmshin/subscriptions","organizations_url":"https://api.github.com/users/matthewrmshin/orgs","repos_url":"https://api.github.com/users/matthewrmshin/repos","events_url":"https://api.github.com/users/matthewrmshin/events{/privacy}","received_events_url":"https://api.github.com/users/matthewrmshin/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/matthewrmshin/rose","description":"Rose: a framework for managing and running meteorological suites.","fork":true,"url":"https://api.github.com/repos/matthewrmshin/rose","forks_url":"https://api.github.com/repos/matthewrmshin/rose/forks","keys_url":"https://api.github.com/repos/matthewrmshin/rose/keys{/key_id}","collaborators_url":"https://api.github.com/repos/matthewrmshin/rose/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/matthewrmshin/rose/teams","hooks_url":"https://api.github.com/repos/matthewrmshin/rose/hooks","issue_events_url":"https://api.github.com/repos/matthewrmshin/rose/issues/events{/number}","events_url":"https://api.github.com/repos/matthewrmshin/rose/events","assignees_url":"https://api.github.com/repos/matthewrmshin/rose/assignees{/user}","branches_url":"https://api.github.com/repos/matthewrmshin/rose/branches{/branch}","tags_url":"https://api.github.com/repos/matthewrmshin/rose/tags","blobs_url":"https://api.github.com/repos/matthewrmshin/rose/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/matthewrmshin/rose/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/matthewrmshin/rose/git/refs{/sha}","trees_url":"https://api.github.com/repos/matthewrmshin/rose/git/trees{/sha}","statuses_url":"https://api.github.com/repos/matthewrmshin/rose/statuses/{sha}","languages_url":"https://api.github.com/repos/matthewrmshin/rose/languages","stargazers_url":"https://api.github.com/repos/matthewrmshin/rose/stargazers","contributors_url":"https://api.github.com/repos/matthewrmshin/rose/contributors","subscribers_url":"https://api.github.com/repos/matthewrmshin/rose/subscribers","subscription_url":"https://api.github.com/repos/matthewrmshin/rose/subscription","commits_url":"https://api.github.com/repos/matthewrmshin/rose/commits{/sha}","git_commits_url":"https://api.github.com/repos/matthewrmshin/rose/git/commits{/sha}","comments_url":"https://api.github.com/repos/matthewrmshin/rose/comments{/number}","issue_comment_url":"https://api.github.com/repos/matthewrmshin/rose/issues/comments{/number}","contents_url":"https://api.github.com/repos/matthewrmshin/rose/contents/{+path}","compare_url":"https://api.github.com/repos/matthewrmshin/rose/compare/{base}...{head}","merges_url":"https://api.github.com/repos/matthewrmshin/rose/merges","archive_url":"https://api.github.com/repos/matthewrmshin/rose/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/matthewrmshin/rose/downloads","issues_url":"https://api.github.com/repos/matthewrmshin/rose/issues{/number}","pulls_url":"https://api.github.com/repos/matthewrmshin/rose/pulls{/number}","milestones_url":"https://api.github.com/repos/matthewrmshin/rose/milestones{/number}","notifications_url":"https://api.github.com/repos/matthewrmshin/rose/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/matthewrmshin/rose/labels{/name}","releases_url":"https://api.github.com/repos/matthewrmshin/rose/releases{/id}","created_at":"2012-10-15T09:01:32Z","updated_at":"2015-04-29T14:25:51Z","pushed_at":"2015-05-01T10:00:08Z","git_url":"git://github.com/matthewrmshin/rose.git","ssh_url":"git@github.com:matthewrmshin/rose.git","clone_url":"https://github.com/matthewrmshin/rose.git","svn_url":"https://github.com/matthewrmshin/rose","homepage":"http://metomi.github.io/rose/doc/","size":19604,"stargazers_count":1,"watchers_count":1,"language":"Python","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":1,"default_branch":"master"}},"base":{"label":"metomi:master","ref":"master","sha":"5ddf3e895c1e9e504753e5de8cfc56aa0f9dd868","user":{"login":"metomi","id":2477494,"avatar_url":"https://avatars.githubusercontent.com/u/2477494?v=3","gravatar_id":"","url":"https://api.github.com/users/metomi","html_url":"https://github.com/metomi","followers_url":"https://api.github.com/users/metomi/followers","following_url":"https://api.github.com/users/metomi/following{/other_user}","gists_url":"https://api.github.com/users/metomi/gists{/gist_id}","starred_url":"https://api.github.com/users/metomi/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/metomi/subscriptions","organizations_url":"https://api.github.com/users/metomi/orgs","repos_url":"https://api.github.com/users/metomi/repos","events_url":"https://api.github.com/users/metomi/events{/privacy}","received_events_url":"https://api.github.com/users/metomi/received_events","type":"Organization","site_admin":false},"repo":{"id":6223866,"name":"rose","full_name":"metomi/rose","owner":{"login":"metomi","id":2477494,"avatar_url":"https://avatars.githubusercontent.com/u/2477494?v=3","gravatar_id":"","url":"https://api.github.com/users/metomi","html_url":"https://github.com/metomi","followers_url":"https://api.github.com/users/metomi/followers","following_url":"https://api.github.com/users/metomi/following{/other_user}","gists_url":"https://api.github.com/users/metomi/gists{/gist_id}","starred_url":"https://api.github.com/users/metomi/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/metomi/subscriptions","organizations_url":"https://api.github.com/users/metomi/orgs","repos_url":"https://api.github.com/users/metomi/repos","events_url":"https://api.github.com/users/metomi/events{/privacy}","received_events_url":"https://api.github.com/users/metomi/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/metomi/rose","description":"Rose: a framework for managing and running meteorological suites.","fork":false,"url":"https://api.github.com/repos/metomi/rose","forks_url":"https://api.github.com/repos/metomi/rose/forks","keys_url":"https://api.github.com/repos/metomi/rose/keys{/key_id}","collaborators_url":"https://api.github.com/repos/metomi/rose/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/metomi/rose/teams","hooks_url":"https://api.github.com/repos/metomi/rose/hooks","issue_events_url":"https://api.github.com/repos/metomi/rose/issues/events{/number}","events_url":"https://api.github.com/repos/metomi/rose/events","assignees_url":"https://api.github.com/repos/metomi/rose/assignees{/user}","branches_url":"https://api.github.com/repos/metomi/rose/branches{/branch}","tags_url":"https://api.github.com/repos/metomi/rose/tags","blobs_url":"https://api.github.com/repos/metomi/rose/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/metomi/rose/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/metomi/rose/git/refs{/sha}","trees_url":"https://api.github.com/repos/metomi/rose/git/trees{/sha}","statuses_url":"https://api.github.com/repos/metomi/rose/statuses/{sha}","languages_url":"https://api.github.com/repos/metomi/rose/languages","stargazers_url":"https://api.github.com/repos/metomi/rose/stargazers","contributors_url":"https://api.github.com/repos/metomi/rose/contributors","subscribers_url":"https://api.github.com/repos/metomi/rose/subscribers","subscription_url":"https://api.github.com/repos/metomi/rose/subscription","commits_url":"https://api.github.com/repos/metomi/rose/commits{/sha}","git_commits_url":"https://api.github.com/repos/metomi/rose/git/commits{/sha}","comments_url":"https://api.github.com/repos/metomi/rose/comments{/number}","issue_comment_url":"https://api.github.com/repos/metomi/rose/issues/comments{/number}","contents_url":"https://api.github.com/repos/metomi/rose/contents/{+path}","compare_url":"https://api.github.com/repos/metomi/rose/compare/{base}...{head}","merges_url":"https://api.github.com/repos/metomi/rose/merges","archive_url":"https://api.github.com/repos/metomi/rose/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/metomi/rose/downloads","issues_url":"https://api.github.com/repos/metomi/rose/issues{/number}","pulls_url":"https://api.github.com/repos/metomi/rose/pulls{/number}","milestones_url":"https://api.github.com/repos/metomi/rose/milestones{/number}","notifications_url":"https://api.github.com/repos/metomi/rose/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/metomi/rose/labels{/name}","releases_url":"https://api.github.com/repos/metomi/rose/releases{/id}","created_at":"2012-10-15T08:31:10Z","updated_at":"2015-04-29T14:18:15Z","pushed_at":"2015-05-01T10:00:09Z","git_url":"git://github.com/metomi/rose.git","ssh_url":"git@github.com:metomi/rose.git","clone_url":"https://github.com/metomi/rose.git","svn_url":"https://github.com/metomi/rose","homepage":"metomi.github.io/rose/doc/","size":20046,"stargazers_count":16,"watchers_count":16,"language":"Python","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":18,"mirror_url":null,"open_issues_count":138,"forks":18,"open_issues":138,"watchers":16,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/metomi/rose/pulls/1604"},"html":{"href":"https://github.com/metomi/rose/pull/1604"},"issue":{"href":"https://api.github.com/repos/metomi/rose/issues/1604"},"comments":{"href":"https://api.github.com/repos/metomi/rose/issues/1604/comments"},"review_comments":{"href":"https://api.github.com/repos/metomi/rose/pulls/1604/comments"},"review_comment":{"href":"https://api.github.com/repos/metomi/rose/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/metomi/rose/pulls/1604/commits"},"statuses":{"href":"https://api.github.com/repos/metomi/rose/statuses/52d4af3e178c1919cbc6284efe2372ebab1f863d"}}}}