{"action":"opened","number":1434,"pull_request":{"url":"https://api.github.com/repos/ramda/ramda/pulls/1434","id":47351281,"html_url":"https://github.com/ramda/ramda/pull/1434","diff_url":"https://github.com/ramda/ramda/pull/1434.diff","patch_url":"https://github.com/ramda/ramda/pull/1434.patch","issue_url":"https://api.github.com/repos/ramda/ramda/issues/1434","number":1434,"state":"open","locked":false,"title":"add @since annotations","user":{"login":"davidchambers","id":210406,"avatar_url":"https://avatars.githubusercontent.com/u/210406?v=3","gravatar_id":"","url":"https://api.github.com/users/davidchambers","html_url":"https://github.com/davidchambers","followers_url":"https://api.github.com/users/davidchambers/followers","following_url":"https://api.github.com/users/davidchambers/following{/other_user}","gists_url":"https://api.github.com/users/davidchambers/gists{/gist_id}","starred_url":"https://api.github.com/users/davidchambers/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/davidchambers/subscriptions","organizations_url":"https://api.github.com/users/davidchambers/orgs","repos_url":"https://api.github.com/users/davidchambers/repos","events_url":"https://api.github.com/users/davidchambers/events{/privacy}","received_events_url":"https://api.github.com/users/davidchambers/received_events","type":"User","site_admin":false},"body":"Closes #1381\r\n\r\nMany thanks to @branneman and @kedashoe for their contributions to this pull request.\r\n\r\nThis is the script I used to add these annotations:\r\n\r\n```\r\n#!/usr/bin/env bash\r\nset -e\r\n\r\nnext_version=v0.18.0\r\nn=$'\\n'\r\n\r\ntags() {\r\n  git tag --list --sort=version:refname\r\n}\r\n\r\nview() {\r\n  git show \"refs/tags/$1:$2\"\r\n}\r\n\r\nfor tag in $(tags) ; do\r\n  view \"$tag\" \"$(node -p \"($(view \"$tag\" package.json)).main\")\" >\"ramda-$tag.js\"\r\ndone\r\n\r\nfor name in $(node -p \"Object.keys(require('./ramda-$(tags | tail -n 1)')).sort().join('\\n')\") ; do\r\n  for tag in $(tags) ; do\r\n    if [[ \"$(node -p \"Object.prototype.hasOwnProperty.call(require('./ramda-$tag'), '$name')\")\" == true ]] ; then\r\n      echo \"R.$name was added in $tag\"\r\n      if [[ -e \"src/$name.js\" ]] ; then\r\n        sed -i \"\" \"s/@memberOf R/@memberOf R\\\\$n * @since $tag/\" \"src/$name.js\"\r\n      fi\r\n      break\r\n    fi\r\n  done\r\ndone\r\n\r\nfor filename in $(find src -depth 1 -name \"*.js\" | xargs grep --files-without-match \"@since v\") ; do\r\n  echo \"R.$(basename -s .js \"$filename\") will be added in $next_version\"\r\n  sed -i \"\" \"s/@memberOf R/@memberOf R\\\\$n * @since $next_version/\" \"$filename\"\r\ndone\r\n\r\nrm ramda-*.js\r\n```\r\n\r\nDo you think it's okay to state `@since v0.1.0` for `R.and`, for example, even though the meaning of `R.and` changed at some point between then and now?\r\n","created_at":"2015-10-10T18:41:32Z","updated_at":"2015-10-10T18:41:32Z","closed_at":null,"merged_at":null,"merge_commit_sha":null,"assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/ramda/ramda/pulls/1434/commits","review_comments_url":"https://api.github.com/repos/ramda/ramda/pulls/1434/comments","review_comment_url":"https://api.github.com/repos/ramda/ramda/pulls/comments{/number}","comments_url":"https://api.github.com/repos/ramda/ramda/issues/1434/comments","statuses_url":"https://api.github.com/repos/ramda/ramda/statuses/f574dfa0fc628e38614003e743b64d41d902088a","head":{"label":"davidchambers:since","ref":"since","sha":"f574dfa0fc628e38614003e743b64d41d902088a","user":{"login":"davidchambers","id":210406,"avatar_url":"https://avatars.githubusercontent.com/u/210406?v=3","gravatar_id":"","url":"https://api.github.com/users/davidchambers","html_url":"https://github.com/davidchambers","followers_url":"https://api.github.com/users/davidchambers/followers","following_url":"https://api.github.com/users/davidchambers/following{/other_user}","gists_url":"https://api.github.com/users/davidchambers/gists{/gist_id}","starred_url":"https://api.github.com/users/davidchambers/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/davidchambers/subscriptions","organizations_url":"https://api.github.com/users/davidchambers/orgs","repos_url":"https://api.github.com/users/davidchambers/repos","events_url":"https://api.github.com/users/davidchambers/events{/privacy}","received_events_url":"https://api.github.com/users/davidchambers/received_events","type":"User","site_admin":false},"repo":{"id":22492045,"name":"ramda","full_name":"davidchambers/ramda","owner":{"login":"davidchambers","id":210406,"avatar_url":"https://avatars.githubusercontent.com/u/210406?v=3","gravatar_id":"","url":"https://api.github.com/users/davidchambers","html_url":"https://github.com/davidchambers","followers_url":"https://api.github.com/users/davidchambers/followers","following_url":"https://api.github.com/users/davidchambers/following{/other_user}","gists_url":"https://api.github.com/users/davidchambers/gists{/gist_id}","starred_url":"https://api.github.com/users/davidchambers/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/davidchambers/subscriptions","organizations_url":"https://api.github.com/users/davidchambers/orgs","repos_url":"https://api.github.com/users/davidchambers/repos","events_url":"https://api.github.com/users/davidchambers/events{/privacy}","received_events_url":"https://api.github.com/users/davidchambers/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/davidchambers/ramda","description":"","fork":true,"url":"https://api.github.com/repos/davidchambers/ramda","forks_url":"https://api.github.com/repos/davidchambers/ramda/forks","keys_url":"https://api.github.com/repos/davidchambers/ramda/keys{/key_id}","collaborators_url":"https://api.github.com/repos/davidchambers/ramda/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/davidchambers/ramda/teams","hooks_url":"https://api.github.com/repos/davidchambers/ramda/hooks","issue_events_url":"https://api.github.com/repos/davidchambers/ramda/issues/events{/number}","events_url":"https://api.github.com/repos/davidchambers/ramda/events","assignees_url":"https://api.github.com/repos/davidchambers/ramda/assignees{/user}","branches_url":"https://api.github.com/repos/davidchambers/ramda/branches{/branch}","tags_url":"https://api.github.com/repos/davidchambers/ramda/tags","blobs_url":"https://api.github.com/repos/davidchambers/ramda/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/davidchambers/ramda/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/davidchambers/ramda/git/refs{/sha}","trees_url":"https://api.github.com/repos/davidchambers/ramda/git/trees{/sha}","statuses_url":"https://api.github.com/repos/davidchambers/ramda/statuses/{sha}","languages_url":"https://api.github.com/repos/davidchambers/ramda/languages","stargazers_url":"https://api.github.com/repos/davidchambers/ramda/stargazers","contributors_url":"https://api.github.com/repos/davidchambers/ramda/contributors","subscribers_url":"https://api.github.com/repos/davidchambers/ramda/subscribers","subscription_url":"https://api.github.com/repos/davidchambers/ramda/subscription","commits_url":"https://api.github.com/repos/davidchambers/ramda/commits{/sha}","git_commits_url":"https://api.github.com/repos/davidchambers/ramda/git/commits{/sha}","comments_url":"https://api.github.com/repos/davidchambers/ramda/comments{/number}","issue_comment_url":"https://api.github.com/repos/davidchambers/ramda/issues/comments{/number}","contents_url":"https://api.github.com/repos/davidchambers/ramda/contents/{+path}","compare_url":"https://api.github.com/repos/davidchambers/ramda/compare/{base}...{head}","merges_url":"https://api.github.com/repos/davidchambers/ramda/merges","archive_url":"https://api.github.com/repos/davidchambers/ramda/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/davidchambers/ramda/downloads","issues_url":"https://api.github.com/repos/davidchambers/ramda/issues{/number}","pulls_url":"https://api.github.com/repos/davidchambers/ramda/pulls{/number}","milestones_url":"https://api.github.com/repos/davidchambers/ramda/milestones{/number}","notifications_url":"https://api.github.com/repos/davidchambers/ramda/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/davidchambers/ramda/labels{/name}","releases_url":"https://api.github.com/repos/davidchambers/ramda/releases{/id}","created_at":"2014-08-01T01:56:04Z","updated_at":"2015-04-24T05:09:49Z","pushed_at":"2015-10-10T18:33:20Z","git_url":"git://github.com/davidchambers/ramda.git","ssh_url":"git@github.com:davidchambers/ramda.git","clone_url":"https://github.com/davidchambers/ramda.git","svn_url":"https://github.com/davidchambers/ramda","homepage":null,"size":7384,"stargazers_count":0,"watchers_count":0,"language":"JavaScript","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"ramda:master","ref":"master","sha":"8df39d157945b54a87e7954620d04bf22311b1b5","user":{"login":"ramda","id":5298359,"avatar_url":"https://avatars.githubusercontent.com/u/5298359?v=3","gravatar_id":"","url":"https://api.github.com/users/ramda","html_url":"https://github.com/ramda","followers_url":"https://api.github.com/users/ramda/followers","following_url":"https://api.github.com/users/ramda/following{/other_user}","gists_url":"https://api.github.com/users/ramda/gists{/gist_id}","starred_url":"https://api.github.com/users/ramda/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ramda/subscriptions","organizations_url":"https://api.github.com/users/ramda/orgs","repos_url":"https://api.github.com/users/ramda/repos","events_url":"https://api.github.com/users/ramda/events{/privacy}","received_events_url":"https://api.github.com/users/ramda/received_events","type":"Organization","site_admin":false},"repo":{"id":10851820,"name":"ramda","full_name":"ramda/ramda","owner":{"login":"ramda","id":5298359,"avatar_url":"https://avatars.githubusercontent.com/u/5298359?v=3","gravatar_id":"","url":"https://api.github.com/users/ramda","html_url":"https://github.com/ramda","followers_url":"https://api.github.com/users/ramda/followers","following_url":"https://api.github.com/users/ramda/following{/other_user}","gists_url":"https://api.github.com/users/ramda/gists{/gist_id}","starred_url":"https://api.github.com/users/ramda/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ramda/subscriptions","organizations_url":"https://api.github.com/users/ramda/orgs","repos_url":"https://api.github.com/users/ramda/repos","events_url":"https://api.github.com/users/ramda/events{/privacy}","received_events_url":"https://api.github.com/users/ramda/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/ramda/ramda","description":":ram: Practical functional Javascript","fork":false,"url":"https://api.github.com/repos/ramda/ramda","forks_url":"https://api.github.com/repos/ramda/ramda/forks","keys_url":"https://api.github.com/repos/ramda/ramda/keys{/key_id}","collaborators_url":"https://api.github.com/repos/ramda/ramda/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/ramda/ramda/teams","hooks_url":"https://api.github.com/repos/ramda/ramda/hooks","issue_events_url":"https://api.github.com/repos/ramda/ramda/issues/events{/number}","events_url":"https://api.github.com/repos/ramda/ramda/events","assignees_url":"https://api.github.com/repos/ramda/ramda/assignees{/user}","branches_url":"https://api.github.com/repos/ramda/ramda/branches{/branch}","tags_url":"https://api.github.com/repos/ramda/ramda/tags","blobs_url":"https://api.github.com/repos/ramda/ramda/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/ramda/ramda/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/ramda/ramda/git/refs{/sha}","trees_url":"https://api.github.com/repos/ramda/ramda/git/trees{/sha}","statuses_url":"https://api.github.com/repos/ramda/ramda/statuses/{sha}","languages_url":"https://api.github.com/repos/ramda/ramda/languages","stargazers_url":"https://api.github.com/repos/ramda/ramda/stargazers","contributors_url":"https://api.github.com/repos/ramda/ramda/contributors","subscribers_url":"https://api.github.com/repos/ramda/ramda/subscribers","subscription_url":"https://api.github.com/repos/ramda/ramda/subscription","commits_url":"https://api.github.com/repos/ramda/ramda/commits{/sha}","git_commits_url":"https://api.github.com/repos/ramda/ramda/git/commits{/sha}","comments_url":"https://api.github.com/repos/ramda/ramda/comments{/number}","issue_comment_url":"https://api.github.com/repos/ramda/ramda/issues/comments{/number}","contents_url":"https://api.github.com/repos/ramda/ramda/contents/{+path}","compare_url":"https://api.github.com/repos/ramda/ramda/compare/{base}...{head}","merges_url":"https://api.github.com/repos/ramda/ramda/merges","archive_url":"https://api.github.com/repos/ramda/ramda/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/ramda/ramda/downloads","issues_url":"https://api.github.com/repos/ramda/ramda/issues{/number}","pulls_url":"https://api.github.com/repos/ramda/ramda/pulls{/number}","milestones_url":"https://api.github.com/repos/ramda/ramda/milestones{/number}","notifications_url":"https://api.github.com/repos/ramda/ramda/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/ramda/ramda/labels{/name}","releases_url":"https://api.github.com/repos/ramda/ramda/releases{/id}","created_at":"2013-06-21T20:32:35Z","updated_at":"2015-10-10T06:53:58Z","pushed_at":"2015-10-10T16:37:08Z","git_url":"git://github.com/ramda/ramda.git","ssh_url":"git@github.com:ramda/ramda.git","clone_url":"https://github.com/ramda/ramda.git","svn_url":"https://github.com/ramda/ramda","homepage":"http://ramdajs.com","size":11619,"stargazers_count":2888,"watchers_count":2888,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":217,"mirror_url":null,"open_issues_count":59,"forks":217,"open_issues":59,"watchers":2888,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/ramda/ramda/pulls/1434"},"html":{"href":"https://github.com/ramda/ramda/pull/1434"},"issue":{"href":"https://api.github.com/repos/ramda/ramda/issues/1434"},"comments":{"href":"https://api.github.com/repos/ramda/ramda/issues/1434/comments"},"review_comments":{"href":"https://api.github.com/repos/ramda/ramda/pulls/1434/comments"},"review_comment":{"href":"https://api.github.com/repos/ramda/ramda/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/ramda/ramda/pulls/1434/commits"},"statuses":{"href":"https://api.github.com/repos/ramda/ramda/statuses/f574dfa0fc628e38614003e743b64d41d902088a"}},"merged":false,"mergeable":null,"mergeable_state":"unknown","merged_by":null,"comments":0,"review_comments":0,"commits":1,"additions":223,"deletions":0,"changed_files":223}}