{"action":"created","comment":{"url":"https://api.github.com/repos/jashkenas/coffeescript/pulls/comments/125089149","pull_request_review_id":47448998,"id":125089149,"diff_hunk":"@@ -0,0 +1,69 @@\n+### Argument parsing and shebang lines\n+\n+#### Trailing `--`\n+\n+Previous versions of CoffeeScript required a `--` after the script to run, but this convention is now deprecated. The new standard is described in the output of `coffee -h`:\n+\n+``` bash\n+> coffee -h\n+\n+Usage: coffee [options] [--] path/to/script.coffee [args]\n+\n+If called without options, `coffee` will run your script.\n+\n+\n+```\n+\n+If the script is run with a `--` after the script, it will show a warning, then run your script.\n+\n+``` bash\n+> coffee path/to/script.coffee --\n+coffee was invoked with '--' as the second positional argument, which is\n+now deprecated. To pass '--' as an argument to a script to run, put an\n+additional '--' before the path to your script.\n+\n+'--' will be removed from the argument list.\n+The positional arguments were: [\"path/to/script.coffee\",\"--\"]\n+...\n+```\n+\n+#### Shebang scripts\n+\n+On non-Windows platforms, a `.coffee` file can be made executable by adding a shebang (`#!`) line at the top of the file and marking the file as executable. For example:\n+\n+`executable-script.coffee`:\n+``` coffeescript\n+#!/usr/bin/env coffee\n+\n+x = 2 + 2\n+console.log x\n+```\n+\n+``` bash\n+> chmod +x ./executable-script.coffee\n+> ./executable-script.coffee\n+4\n+```\n+\n+Due to a bug in the argument parsing of previous CoffeeScript versions, this used to fail when trying to pass arguments to the script. Some users on OSX worked around the problem by using `#!/usr/bin/env coffee --` at the top of the file instead. However, that won't work on Linux, which cannot parse shebang lines with more than a single argument. While these scripts will still run on OSX, CoffeeScript will now display a warning before compiling or evaluating files that begin with a too-long shebang line:","path":"documentation/sections/breaking_changes_argument_parsing_and_shebang_lines.md","position":null,"original_position":48,"commit_id":"b9291ae54ec268880b447226bb11da84af40409c","original_commit_id":"14df734f70b5bf500ac4d09b2a11fadb31676de2","user":{"login":"cosmicexplorer","id":1305167,"avatar_url":"https://avatars2.githubusercontent.com/u/1305167?v=3","gravatar_id":"","url":"https://api.github.com/users/cosmicexplorer","html_url":"https://github.com/cosmicexplorer","followers_url":"https://api.github.com/users/cosmicexplorer/followers","following_url":"https://api.github.com/users/cosmicexplorer/following{/other_user}","gists_url":"https://api.github.com/users/cosmicexplorer/gists{/gist_id}","starred_url":"https://api.github.com/users/cosmicexplorer/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cosmicexplorer/subscriptions","organizations_url":"https://api.github.com/users/cosmicexplorer/orgs","repos_url":"https://api.github.com/users/cosmicexplorer/repos","events_url":"https://api.github.com/users/cosmicexplorer/events{/privacy}","received_events_url":"https://api.github.com/users/cosmicexplorer/received_events","type":"User","site_admin":false},"body":"Fixed both of those.","created_at":"2017-06-30T17:25:04Z","updated_at":"2017-06-30T17:25:04Z","html_url":"https://github.com/jashkenas/coffeescript/pull/3946#discussion_r125089149","pull_request_url":"https://api.github.com/repos/jashkenas/coffeescript/pulls/3946","_links":{"self":{"href":"https://api.github.com/repos/jashkenas/coffeescript/pulls/comments/125089149"},"html":{"href":"https://github.com/jashkenas/coffeescript/pull/3946#discussion_r125089149"},"pull_request":{"href":"https://api.github.com/repos/jashkenas/coffeescript/pulls/3946"}}},"pull_request":{"url":"https://api.github.com/repos/jashkenas/coffeescript/pulls/3946","id":33428305,"html_url":"https://github.com/jashkenas/coffeescript/pull/3946","diff_url":"https://github.com/jashkenas/coffeescript/pull/3946.diff","patch_url":"https://github.com/jashkenas/coffeescript/pull/3946.patch","issue_url":"https://api.github.com/repos/jashkenas/coffeescript/issues/3946","number":3946,"state":"open","locked":false,"title":"[CS2] Add #! support for executable scripts on Linux.","user":{"login":"cosmicexplorer","id":1305167,"avatar_url":"https://avatars2.githubusercontent.com/u/1305167?v=3","gravatar_id":"","url":"https://api.github.com/users/cosmicexplorer","html_url":"https://github.com/cosmicexplorer","followers_url":"https://api.github.com/users/cosmicexplorer/followers","following_url":"https://api.github.com/users/cosmicexplorer/following{/other_user}","gists_url":"https://api.github.com/users/cosmicexplorer/gists{/gist_id}","starred_url":"https://api.github.com/users/cosmicexplorer/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cosmicexplorer/subscriptions","organizations_url":"https://api.github.com/users/cosmicexplorer/orgs","repos_url":"https://api.github.com/users/cosmicexplorer/repos","events_url":"https://api.github.com/users/cosmicexplorer/events{/privacy}","received_events_url":"https://api.github.com/users/cosmicexplorer/received_events","type":"User","site_admin":false},"body":"Pass arguments to executable script unchanged if using \"#!/usr/bin/env\ncoffee\". (Previously, \"./test.coffee -abck\" would be turned into \"-a -b -c -k\",\nfor example.)\n\nFixes #1752.\n","created_at":"2015-04-16T08:24:48Z","updated_at":"2017-06-30T17:25:04Z","closed_at":null,"merged_at":null,"merge_commit_sha":"f12caf1d4623e6952c8dc06c93b9d8147d64deff","assignee":null,"assignees":[],"requested_reviewers":[],"milestone":{"url":"https://api.github.com/repos/jashkenas/coffeescript/milestones/10","html_url":"https://github.com/jashkenas/coffeescript/milestone/10","labels_url":"https://api.github.com/repos/jashkenas/coffeescript/milestones/10/labels","id":2015479,"number":10,"title":"2.0.0","description":"A breaking-change release of CoffeeScript that outputs the latest implemented ECMAScript syntax whenever possible.","creator":{"login":"GeoffreyBooth","id":456802,"avatar_url":"https://avatars1.githubusercontent.com/u/456802?v=3","gravatar_id":"","url":"https://api.github.com/users/GeoffreyBooth","html_url":"https://github.com/GeoffreyBooth","followers_url":"https://api.github.com/users/GeoffreyBooth/followers","following_url":"https://api.github.com/users/GeoffreyBooth/following{/other_user}","gists_url":"https://api.github.com/users/GeoffreyBooth/gists{/gist_id}","starred_url":"https://api.github.com/users/GeoffreyBooth/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/GeoffreyBooth/subscriptions","organizations_url":"https://api.github.com/users/GeoffreyBooth/orgs","repos_url":"https://api.github.com/users/GeoffreyBooth/repos","events_url":"https://api.github.com/users/GeoffreyBooth/events{/privacy}","received_events_url":"https://api.github.com/users/GeoffreyBooth/received_events","type":"User","site_admin":false},"open_issues":5,"closed_issues":57,"state":"open","created_at":"2016-09-20T04:18:33Z","updated_at":"2017-06-30T16:58:06Z","due_on":null,"closed_at":null},"commits_url":"https://api.github.com/repos/jashkenas/coffeescript/pulls/3946/commits","review_comments_url":"https://api.github.com/repos/jashkenas/coffeescript/pulls/3946/comments","review_comment_url":"https://api.github.com/repos/jashkenas/coffeescript/pulls/comments{/number}","comments_url":"https://api.github.com/repos/jashkenas/coffeescript/issues/3946/comments","statuses_url":"https://api.github.com/repos/jashkenas/coffeescript/statuses/b9291ae54ec268880b447226bb11da84af40409c","head":{"label":"cosmicexplorer:master","ref":"master","sha":"b9291ae54ec268880b447226bb11da84af40409c","user":{"login":"cosmicexplorer","id":1305167,"avatar_url":"https://avatars2.githubusercontent.com/u/1305167?v=3","gravatar_id":"","url":"https://api.github.com/users/cosmicexplorer","html_url":"https://github.com/cosmicexplorer","followers_url":"https://api.github.com/users/cosmicexplorer/followers","following_url":"https://api.github.com/users/cosmicexplorer/following{/other_user}","gists_url":"https://api.github.com/users/cosmicexplorer/gists{/gist_id}","starred_url":"https://api.github.com/users/cosmicexplorer/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cosmicexplorer/subscriptions","organizations_url":"https://api.github.com/users/cosmicexplorer/orgs","repos_url":"https://api.github.com/users/cosmicexplorer/repos","events_url":"https://api.github.com/users/cosmicexplorer/events{/privacy}","received_events_url":"https://api.github.com/users/cosmicexplorer/received_events","type":"User","site_admin":false},"repo":{"id":34043418,"name":"coffeescript","full_name":"cosmicexplorer/coffeescript","owner":{"login":"cosmicexplorer","id":1305167,"avatar_url":"https://avatars2.githubusercontent.com/u/1305167?v=3","gravatar_id":"","url":"https://api.github.com/users/cosmicexplorer","html_url":"https://github.com/cosmicexplorer","followers_url":"https://api.github.com/users/cosmicexplorer/followers","following_url":"https://api.github.com/users/cosmicexplorer/following{/other_user}","gists_url":"https://api.github.com/users/cosmicexplorer/gists{/gist_id}","starred_url":"https://api.github.com/users/cosmicexplorer/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cosmicexplorer/subscriptions","organizations_url":"https://api.github.com/users/cosmicexplorer/orgs","repos_url":"https://api.github.com/users/cosmicexplorer/repos","events_url":"https://api.github.com/users/cosmicexplorer/events{/privacy}","received_events_url":"https://api.github.com/users/cosmicexplorer/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/cosmicexplorer/coffeescript","description":"Unfancy JavaScript","fork":true,"url":"https://api.github.com/repos/cosmicexplorer/coffeescript","forks_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/forks","keys_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/keys{/key_id}","collaborators_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/teams","hooks_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/hooks","issue_events_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/issues/events{/number}","events_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/events","assignees_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/assignees{/user}","branches_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/branches{/branch}","tags_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/tags","blobs_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/git/refs{/sha}","trees_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/git/trees{/sha}","statuses_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/statuses/{sha}","languages_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/languages","stargazers_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/stargazers","contributors_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/contributors","subscribers_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/subscribers","subscription_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/subscription","commits_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/commits{/sha}","git_commits_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/git/commits{/sha}","comments_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/comments{/number}","issue_comment_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/issues/comments{/number}","contents_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/contents/{+path}","compare_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/compare/{base}...{head}","merges_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/merges","archive_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/downloads","issues_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/issues{/number}","pulls_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/pulls{/number}","milestones_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/milestones{/number}","notifications_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/labels{/name}","releases_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/releases{/id}","deployments_url":"https://api.github.com/repos/cosmicexplorer/coffeescript/deployments","created_at":"2015-04-16T08:22:44Z","updated_at":"2017-04-20T01:18:27Z","pushed_at":"2017-06-30T17:21:57Z","git_url":"git://github.com/cosmicexplorer/coffeescript.git","ssh_url":"git@github.com:cosmicexplorer/coffeescript.git","clone_url":"https://github.com/cosmicexplorer/coffeescript.git","svn_url":"https://github.com/cosmicexplorer/coffeescript","homepage":"http://coffeescript.org/","size":20020,"stargazers_count":0,"watchers_count":0,"language":"CoffeeScript","has_issues":false,"has_projects":true,"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":"jashkenas:2","ref":"2","sha":"1f31073201e87624f86d6ed34ab81191595b0aa6","user":{"login":"jashkenas","id":4732,"avatar_url":"https://avatars0.githubusercontent.com/u/4732?v=3","gravatar_id":"","url":"https://api.github.com/users/jashkenas","html_url":"https://github.com/jashkenas","followers_url":"https://api.github.com/users/jashkenas/followers","following_url":"https://api.github.com/users/jashkenas/following{/other_user}","gists_url":"https://api.github.com/users/jashkenas/gists{/gist_id}","starred_url":"https://api.github.com/users/jashkenas/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jashkenas/subscriptions","organizations_url":"https://api.github.com/users/jashkenas/orgs","repos_url":"https://api.github.com/users/jashkenas/repos","events_url":"https://api.github.com/users/jashkenas/events{/privacy}","received_events_url":"https://api.github.com/users/jashkenas/received_events","type":"User","site_admin":false},"repo":{"id":441269,"name":"coffeescript","full_name":"jashkenas/coffeescript","owner":{"login":"jashkenas","id":4732,"avatar_url":"https://avatars0.githubusercontent.com/u/4732?v=3","gravatar_id":"","url":"https://api.github.com/users/jashkenas","html_url":"https://github.com/jashkenas","followers_url":"https://api.github.com/users/jashkenas/followers","following_url":"https://api.github.com/users/jashkenas/following{/other_user}","gists_url":"https://api.github.com/users/jashkenas/gists{/gist_id}","starred_url":"https://api.github.com/users/jashkenas/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jashkenas/subscriptions","organizations_url":"https://api.github.com/users/jashkenas/orgs","repos_url":"https://api.github.com/users/jashkenas/repos","events_url":"https://api.github.com/users/jashkenas/events{/privacy}","received_events_url":"https://api.github.com/users/jashkenas/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/jashkenas/coffeescript","description":"Unfancy JavaScript","fork":false,"url":"https://api.github.com/repos/jashkenas/coffeescript","forks_url":"https://api.github.com/repos/jashkenas/coffeescript/forks","keys_url":"https://api.github.com/repos/jashkenas/coffeescript/keys{/key_id}","collaborators_url":"https://api.github.com/repos/jashkenas/coffeescript/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/jashkenas/coffeescript/teams","hooks_url":"https://api.github.com/repos/jashkenas/coffeescript/hooks","issue_events_url":"https://api.github.com/repos/jashkenas/coffeescript/issues/events{/number}","events_url":"https://api.github.com/repos/jashkenas/coffeescript/events","assignees_url":"https://api.github.com/repos/jashkenas/coffeescript/assignees{/user}","branches_url":"https://api.github.com/repos/jashkenas/coffeescript/branches{/branch}","tags_url":"https://api.github.com/repos/jashkenas/coffeescript/tags","blobs_url":"https://api.github.com/repos/jashkenas/coffeescript/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/jashkenas/coffeescript/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/jashkenas/coffeescript/git/refs{/sha}","trees_url":"https://api.github.com/repos/jashkenas/coffeescript/git/trees{/sha}","statuses_url":"https://api.github.com/repos/jashkenas/coffeescript/statuses/{sha}","languages_url":"https://api.github.com/repos/jashkenas/coffeescript/languages","stargazers_url":"https://api.github.com/repos/jashkenas/coffeescript/stargazers","contributors_url":"https://api.github.com/repos/jashkenas/coffeescript/contributors","subscribers_url":"https://api.github.com/repos/jashkenas/coffeescript/subscribers","subscription_url":"https://api.github.com/repos/jashkenas/coffeescript/subscription","commits_url":"https://api.github.com/repos/jashkenas/coffeescript/commits{/sha}","git_commits_url":"https://api.github.com/repos/jashkenas/coffeescript/git/commits{/sha}","comments_url":"https://api.github.com/repos/jashkenas/coffeescript/comments{/number}","issue_comment_url":"https://api.github.com/repos/jashkenas/coffeescript/issues/comments{/number}","contents_url":"https://api.github.com/repos/jashkenas/coffeescript/contents/{+path}","compare_url":"https://api.github.com/repos/jashkenas/coffeescript/compare/{base}...{head}","merges_url":"https://api.github.com/repos/jashkenas/coffeescript/merges","archive_url":"https://api.github.com/repos/jashkenas/coffeescript/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/jashkenas/coffeescript/downloads","issues_url":"https://api.github.com/repos/jashkenas/coffeescript/issues{/number}","pulls_url":"https://api.github.com/repos/jashkenas/coffeescript/pulls{/number}","milestones_url":"https://api.github.com/repos/jashkenas/coffeescript/milestones{/number}","notifications_url":"https://api.github.com/repos/jashkenas/coffeescript/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/jashkenas/coffeescript/labels{/name}","releases_url":"https://api.github.com/repos/jashkenas/coffeescript/releases{/id}","deployments_url":"https://api.github.com/repos/jashkenas/coffeescript/deployments","created_at":"2009-12-18T01:39:53Z","updated_at":"2017-06-30T15:16:29Z","pushed_at":"2017-06-30T17:21:59Z","git_url":"git://github.com/jashkenas/coffeescript.git","ssh_url":"git@github.com:jashkenas/coffeescript.git","clone_url":"https://github.com/jashkenas/coffeescript.git","svn_url":"https://github.com/jashkenas/coffeescript","homepage":"http://coffeescript.org/","size":19854,"stargazers_count":14047,"watchers_count":14047,"language":"CoffeeScript","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":1912,"mirror_url":null,"open_issues_count":76,"forks":1912,"open_issues":76,"watchers":14047,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/jashkenas/coffeescript/pulls/3946"},"html":{"href":"https://github.com/jashkenas/coffeescript/pull/3946"},"issue":{"href":"https://api.github.com/repos/jashkenas/coffeescript/issues/3946"},"comments":{"href":"https://api.github.com/repos/jashkenas/coffeescript/issues/3946/comments"},"review_comments":{"href":"https://api.github.com/repos/jashkenas/coffeescript/pulls/3946/comments"},"review_comment":{"href":"https://api.github.com/repos/jashkenas/coffeescript/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/jashkenas/coffeescript/pulls/3946/commits"},"statuses":{"href":"https://api.github.com/repos/jashkenas/coffeescript/statuses/b9291ae54ec268880b447226bb11da84af40409c"}}}}
{"actor":{"display_login":"cosmicexplorer"}}