{"action":"created","comment":{"url":"https://api.github.com/repos/datalad/datalad/pulls/comments/193167715","pull_request_review_id":126087166,"id":193167715,"node_id":"MDI0OlB1bGxSZXF1ZXN0UmV2aWV3Q29tbWVudDE5MzE2NzcxNQ==","diff_hunk":"@@ -97,29 +97,94 @@ def _guess_exec(script_file):\n         return u'bash \"{script}\" \"{ds}\" {args}'\n     elif script_file.endswith('.py'):\n         return u'python \"{script}\" \"{ds}\" {args}'\n-    raise ValueError(\"NO IDEA\")\n+    raise ValueError(\"No idea how to execute procedure %s. Missing 'execute' permissions?\", script_file)\n \n \n @build_doc\n class RunProcedure(Interface):\n-    \"\"\"\n-    DO stuff\n-    datalad.locations.dataset-procedures\n-    datalad.locations.user-procedures\n-    datalad.locations.system-procedures\n+    \"\"\"Run prepared procedures (DataLad scripts) on a dataset\n+\n+    *Concept*\n+\n+    A \"procedure\" is an algorithm with the purpose to process a dataset in a\n+    particular way. Procedures can be useful in a wide range of scenarios,\n+    like adjusting dataset configuration in a uniform fashion, populating\n+    a dataset with particular content, or automating other routine tasks,\n+    such as synchronizing dataset content with certain siblings.\n+\n+    Implementations of some procedures are shipped together with DataLad,\n+    but additional procedures can be provided by 1) any DataLad extension,\n+    2) any dataset, 3) a local user, or 4) a local system administrator.\n+    DataLad will look for procedures in the following locations and order:\n+\n+    Directories identified by the configuration settings\n+\n+    1. 'datalad.locations.dataset-procedures'\n+\n+    2. 'datalad.locations.user-procedures' (on a *nix system this defaults\n+       to: '$HOME/.config/datalad/procedures')\n+\n+    3. 'datalad.locations.system-procedures' (on a *unix system this","path":"datalad/interface/run_procedure.py","position":37,"original_position":37,"commit_id":"6a759670b05cd3630d72da555b3d3449122af66b","original_commit_id":"59e867d32ad1db739a64a88d8cad08882be6f5de","user":{"login":"mih","id":136479,"node_id":"MDQ6VXNlcjEzNjQ3OQ==","avatar_url":"https://avatars1.githubusercontent.com/u/136479?v=4","gravatar_id":"","url":"https://api.github.com/users/mih","html_url":"https://github.com/mih","followers_url":"https://api.github.com/users/mih/followers","following_url":"https://api.github.com/users/mih/following{/other_user}","gists_url":"https://api.github.com/users/mih/gists{/gist_id}","starred_url":"https://api.github.com/users/mih/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mih/subscriptions","organizations_url":"https://api.github.com/users/mih/orgs","repos_url":"https://api.github.com/users/mih/repos","events_url":"https://api.github.com/users/mih/events{/privacy}","received_events_url":"https://api.github.com/users/mih/received_events","type":"User","site_admin":false},"body":"No idea, but if you bring it up, probably not. Kill entirely or say Linux? Feel free to push into the PR, BTW.","created_at":"2018-06-05T18:03:40Z","updated_at":"2018-06-05T18:03:40Z","html_url":"https://github.com/datalad/datalad/pull/2609#discussion_r193167715","pull_request_url":"https://api.github.com/repos/datalad/datalad/pulls/2609","author_association":"MEMBER","_links":{"self":{"href":"https://api.github.com/repos/datalad/datalad/pulls/comments/193167715"},"html":{"href":"https://github.com/datalad/datalad/pull/2609#discussion_r193167715"},"pull_request":{"href":"https://api.github.com/repos/datalad/datalad/pulls/2609"}},"in_reply_to_id":193152815},"pull_request":{"url":"https://api.github.com/repos/datalad/datalad/pulls/2609","id":192631358,"node_id":"MDExOlB1bGxSZXF1ZXN0MTkyNjMxMzU4","html_url":"https://github.com/datalad/datalad/pull/2609","diff_url":"https://github.com/datalad/datalad/pull/2609.diff","patch_url":"https://github.com/datalad/datalad/pull/2609.patch","issue_url":"https://api.github.com/repos/datalad/datalad/issues/2609","number":2609,"state":"open","locked":false,"title":"DOC: Better manpages (fixes gh-2608)","user":{"login":"mih","id":136479,"node_id":"MDQ6VXNlcjEzNjQ3OQ==","avatar_url":"https://avatars1.githubusercontent.com/u/136479?v=4","gravatar_id":"","url":"https://api.github.com/users/mih","html_url":"https://github.com/mih","followers_url":"https://api.github.com/users/mih/followers","following_url":"https://api.github.com/users/mih/following{/other_user}","gists_url":"https://api.github.com/users/mih/gists{/gist_id}","starred_url":"https://api.github.com/users/mih/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mih/subscriptions","organizations_url":"https://api.github.com/users/mih/orgs","repos_url":"https://api.github.com/users/mih/repos","events_url":"https://api.github.com/users/mih/events{/privacy}","received_events_url":"https://api.github.com/users/mih/received_events","type":"User","site_admin":false},"body":"- proper NAME section (uses first line of description, worked for all\r\ncommands but the main datalad entrypoint, needed update)\r\n","created_at":"2018-06-05T08:45:22Z","updated_at":"2018-06-05T18:03:40Z","closed_at":null,"merged_at":null,"merge_commit_sha":"dc8119de73bc052766446e033e034fbd01d096bb","assignee":null,"assignees":[],"requested_reviewers":[],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/datalad/datalad/pulls/2609/commits","review_comments_url":"https://api.github.com/repos/datalad/datalad/pulls/2609/comments","review_comment_url":"https://api.github.com/repos/datalad/datalad/pulls/comments{/number}","comments_url":"https://api.github.com/repos/datalad/datalad/issues/2609/comments","statuses_url":"https://api.github.com/repos/datalad/datalad/statuses/6a759670b05cd3630d72da555b3d3449122af66b","head":{"label":"mih:docs","ref":"docs","sha":"6a759670b05cd3630d72da555b3d3449122af66b","user":{"login":"mih","id":136479,"node_id":"MDQ6VXNlcjEzNjQ3OQ==","avatar_url":"https://avatars1.githubusercontent.com/u/136479?v=4","gravatar_id":"","url":"https://api.github.com/users/mih","html_url":"https://github.com/mih","followers_url":"https://api.github.com/users/mih/followers","following_url":"https://api.github.com/users/mih/following{/other_user}","gists_url":"https://api.github.com/users/mih/gists{/gist_id}","starred_url":"https://api.github.com/users/mih/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mih/subscriptions","organizations_url":"https://api.github.com/users/mih/orgs","repos_url":"https://api.github.com/users/mih/repos","events_url":"https://api.github.com/users/mih/events{/privacy}","received_events_url":"https://api.github.com/users/mih/received_events","type":"User","site_admin":false},"repo":{"id":34503646,"node_id":"MDEwOlJlcG9zaXRvcnkzNDUwMzY0Ng==","name":"datalad","full_name":"mih/datalad","owner":{"login":"mih","id":136479,"node_id":"MDQ6VXNlcjEzNjQ3OQ==","avatar_url":"https://avatars1.githubusercontent.com/u/136479?v=4","gravatar_id":"","url":"https://api.github.com/users/mih","html_url":"https://github.com/mih","followers_url":"https://api.github.com/users/mih/followers","following_url":"https://api.github.com/users/mih/following{/other_user}","gists_url":"https://api.github.com/users/mih/gists{/gist_id}","starred_url":"https://api.github.com/users/mih/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mih/subscriptions","organizations_url":"https://api.github.com/users/mih/orgs","repos_url":"https://api.github.com/users/mih/repos","events_url":"https://api.github.com/users/mih/events{/privacy}","received_events_url":"https://api.github.com/users/mih/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/mih/datalad","description":"Keep scientific data under control by git  and git-annex","fork":true,"url":"https://api.github.com/repos/mih/datalad","forks_url":"https://api.github.com/repos/mih/datalad/forks","keys_url":"https://api.github.com/repos/mih/datalad/keys{/key_id}","collaborators_url":"https://api.github.com/repos/mih/datalad/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/mih/datalad/teams","hooks_url":"https://api.github.com/repos/mih/datalad/hooks","issue_events_url":"https://api.github.com/repos/mih/datalad/issues/events{/number}","events_url":"https://api.github.com/repos/mih/datalad/events","assignees_url":"https://api.github.com/repos/mih/datalad/assignees{/user}","branches_url":"https://api.github.com/repos/mih/datalad/branches{/branch}","tags_url":"https://api.github.com/repos/mih/datalad/tags","blobs_url":"https://api.github.com/repos/mih/datalad/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/mih/datalad/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/mih/datalad/git/refs{/sha}","trees_url":"https://api.github.com/repos/mih/datalad/git/trees{/sha}","statuses_url":"https://api.github.com/repos/mih/datalad/statuses/{sha}","languages_url":"https://api.github.com/repos/mih/datalad/languages","stargazers_url":"https://api.github.com/repos/mih/datalad/stargazers","contributors_url":"https://api.github.com/repos/mih/datalad/contributors","subscribers_url":"https://api.github.com/repos/mih/datalad/subscribers","subscription_url":"https://api.github.com/repos/mih/datalad/subscription","commits_url":"https://api.github.com/repos/mih/datalad/commits{/sha}","git_commits_url":"https://api.github.com/repos/mih/datalad/git/commits{/sha}","comments_url":"https://api.github.com/repos/mih/datalad/comments{/number}","issue_comment_url":"https://api.github.com/repos/mih/datalad/issues/comments{/number}","contents_url":"https://api.github.com/repos/mih/datalad/contents/{+path}","compare_url":"https://api.github.com/repos/mih/datalad/compare/{base}...{head}","merges_url":"https://api.github.com/repos/mih/datalad/merges","archive_url":"https://api.github.com/repos/mih/datalad/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/mih/datalad/downloads","issues_url":"https://api.github.com/repos/mih/datalad/issues{/number}","pulls_url":"https://api.github.com/repos/mih/datalad/pulls{/number}","milestones_url":"https://api.github.com/repos/mih/datalad/milestones{/number}","notifications_url":"https://api.github.com/repos/mih/datalad/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/mih/datalad/labels{/name}","releases_url":"https://api.github.com/repos/mih/datalad/releases{/id}","deployments_url":"https://api.github.com/repos/mih/datalad/deployments","created_at":"2015-04-24T07:11:39Z","updated_at":"2018-05-25T05:31:17Z","pushed_at":"2018-06-05T17:24:29Z","git_url":"git://github.com/mih/datalad.git","ssh_url":"git@github.com:mih/datalad.git","clone_url":"https://github.com/mih/datalad.git","svn_url":"https://github.com/mih/datalad","homepage":null,"size":12901,"stargazers_count":0,"watchers_count":0,"language":"Python","has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"archived":false,"open_issues_count":2,"license":{"key":"other","name":"Other","spdx_id":null,"url":null,"node_id":"MDc6TGljZW5zZTA="},"forks":0,"open_issues":2,"watchers":0,"default_branch":"master"}},"base":{"label":"datalad:master","ref":"master","sha":"97f990caff182547845e1096a4044d9cd17e6a31","user":{"login":"datalad","id":8927200,"node_id":"MDEyOk9yZ2FuaXphdGlvbjg5MjcyMDA=","avatar_url":"https://avatars2.githubusercontent.com/u/8927200?v=4","gravatar_id":"","url":"https://api.github.com/users/datalad","html_url":"https://github.com/datalad","followers_url":"https://api.github.com/users/datalad/followers","following_url":"https://api.github.com/users/datalad/following{/other_user}","gists_url":"https://api.github.com/users/datalad/gists{/gist_id}","starred_url":"https://api.github.com/users/datalad/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/datalad/subscriptions","organizations_url":"https://api.github.com/users/datalad/orgs","repos_url":"https://api.github.com/users/datalad/repos","events_url":"https://api.github.com/users/datalad/events{/privacy}","received_events_url":"https://api.github.com/users/datalad/received_events","type":"Organization","site_admin":false},"repo":{"id":14052034,"node_id":"MDEwOlJlcG9zaXRvcnkxNDA1MjAzNA==","name":"datalad","full_name":"datalad/datalad","owner":{"login":"datalad","id":8927200,"node_id":"MDEyOk9yZ2FuaXphdGlvbjg5MjcyMDA=","avatar_url":"https://avatars2.githubusercontent.com/u/8927200?v=4","gravatar_id":"","url":"https://api.github.com/users/datalad","html_url":"https://github.com/datalad","followers_url":"https://api.github.com/users/datalad/followers","following_url":"https://api.github.com/users/datalad/following{/other_user}","gists_url":"https://api.github.com/users/datalad/gists{/gist_id}","starred_url":"https://api.github.com/users/datalad/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/datalad/subscriptions","organizations_url":"https://api.github.com/users/datalad/orgs","repos_url":"https://api.github.com/users/datalad/repos","events_url":"https://api.github.com/users/datalad/events{/privacy}","received_events_url":"https://api.github.com/users/datalad/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/datalad/datalad","description":"Keep scientific data under control with git  and git-annex","fork":false,"url":"https://api.github.com/repos/datalad/datalad","forks_url":"https://api.github.com/repos/datalad/datalad/forks","keys_url":"https://api.github.com/repos/datalad/datalad/keys{/key_id}","collaborators_url":"https://api.github.com/repos/datalad/datalad/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/datalad/datalad/teams","hooks_url":"https://api.github.com/repos/datalad/datalad/hooks","issue_events_url":"https://api.github.com/repos/datalad/datalad/issues/events{/number}","events_url":"https://api.github.com/repos/datalad/datalad/events","assignees_url":"https://api.github.com/repos/datalad/datalad/assignees{/user}","branches_url":"https://api.github.com/repos/datalad/datalad/branches{/branch}","tags_url":"https://api.github.com/repos/datalad/datalad/tags","blobs_url":"https://api.github.com/repos/datalad/datalad/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/datalad/datalad/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/datalad/datalad/git/refs{/sha}","trees_url":"https://api.github.com/repos/datalad/datalad/git/trees{/sha}","statuses_url":"https://api.github.com/repos/datalad/datalad/statuses/{sha}","languages_url":"https://api.github.com/repos/datalad/datalad/languages","stargazers_url":"https://api.github.com/repos/datalad/datalad/stargazers","contributors_url":"https://api.github.com/repos/datalad/datalad/contributors","subscribers_url":"https://api.github.com/repos/datalad/datalad/subscribers","subscription_url":"https://api.github.com/repos/datalad/datalad/subscription","commits_url":"https://api.github.com/repos/datalad/datalad/commits{/sha}","git_commits_url":"https://api.github.com/repos/datalad/datalad/git/commits{/sha}","comments_url":"https://api.github.com/repos/datalad/datalad/comments{/number}","issue_comment_url":"https://api.github.com/repos/datalad/datalad/issues/comments{/number}","contents_url":"https://api.github.com/repos/datalad/datalad/contents/{+path}","compare_url":"https://api.github.com/repos/datalad/datalad/compare/{base}...{head}","merges_url":"https://api.github.com/repos/datalad/datalad/merges","archive_url":"https://api.github.com/repos/datalad/datalad/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/datalad/datalad/downloads","issues_url":"https://api.github.com/repos/datalad/datalad/issues{/number}","pulls_url":"https://api.github.com/repos/datalad/datalad/pulls{/number}","milestones_url":"https://api.github.com/repos/datalad/datalad/milestones{/number}","notifications_url":"https://api.github.com/repos/datalad/datalad/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/datalad/datalad/labels{/name}","releases_url":"https://api.github.com/repos/datalad/datalad/releases{/id}","deployments_url":"https://api.github.com/repos/datalad/datalad/deployments","created_at":"2013-11-01T19:40:08Z","updated_at":"2018-06-05T05:07:44Z","pushed_at":"2018-06-05T17:55:20Z","git_url":"git://github.com/datalad/datalad.git","ssh_url":"git@github.com:datalad/datalad.git","clone_url":"https://github.com/datalad/datalad.git","svn_url":"https://github.com/datalad/datalad","homepage":"http://datalad.org","size":13393,"stargazers_count":99,"watchers_count":99,"language":"Python","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":35,"mirror_url":null,"archived":false,"open_issues_count":427,"license":{"key":"other","name":"Other","spdx_id":null,"url":null,"node_id":"MDc6TGljZW5zZTA="},"forks":35,"open_issues":427,"watchers":99,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/datalad/datalad/pulls/2609"},"html":{"href":"https://github.com/datalad/datalad/pull/2609"},"issue":{"href":"https://api.github.com/repos/datalad/datalad/issues/2609"},"comments":{"href":"https://api.github.com/repos/datalad/datalad/issues/2609/comments"},"review_comments":{"href":"https://api.github.com/repos/datalad/datalad/pulls/2609/comments"},"review_comment":{"href":"https://api.github.com/repos/datalad/datalad/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/datalad/datalad/pulls/2609/commits"},"statuses":{"href":"https://api.github.com/repos/datalad/datalad/statuses/6a759670b05cd3630d72da555b3d3449122af66b"}},"author_association":"MEMBER"}}
{"actor":{"display_login":"mih"}}