{"action":"opened","number":12146,"pull_request":{"url":"https://api.github.com/repos/JuliaLang/julia/pulls/12146","id":39953495,"html_url":"https://github.com/JuliaLang/julia/pull/12146","diff_url":"https://github.com/JuliaLang/julia/pull/12146.diff","patch_url":"https://github.com/JuliaLang/julia/pull/12146.patch","issue_url":"https://api.github.com/repos/JuliaLang/julia/issues/12146","number":12146,"state":"open","locked":false,"title":"RFC: overhaul of \"Scope\" manual section","user":{"login":"mauro3","id":4098145,"avatar_url":"https://avatars.githubusercontent.com/u/4098145?v=3","gravatar_id":"","url":"https://api.github.com/users/mauro3","html_url":"https://github.com/mauro3","followers_url":"https://api.github.com/users/mauro3/followers","following_url":"https://api.github.com/users/mauro3/following{/other_user}","gists_url":"https://api.github.com/users/mauro3/gists{/gist_id}","starred_url":"https://api.github.com/users/mauro3/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mauro3/subscriptions","organizations_url":"https://api.github.com/users/mauro3/orgs","repos_url":"https://api.github.com/users/mauro3/repos","events_url":"https://api.github.com/users/mauro3/events{/privacy}","received_events_url":"https://api.github.com/users/mauro3/received_events","type":"User","site_admin":false},"body":"Trying to fix issues #9469 and #9955, this turned into quite a substantial re-write of the \"Scope\" section of the manual.  I hope this is ok, please give feedback.  I do think that documenting global scope is addressed (#9469), as is the difference between soft and hard local scope (#9955), and the whole section maybe a bit more logically structured now.  A semi rendered version is [here](https://github.com/mauro3/julia/blob/41911d96d86397168ade1f39914a8d7ed1653558/doc/manual/variables-and-scoping.rst).\r\n\r\nQuestion: is the [statement](https://github.com/mauro3/julia/blame/41911d96d86397168ade1f39914a8d7ed1653558/doc/manual/variables-and-scoping.rst#L203) about `global` never having any effect in soft local scopes correct?\r\n\r\nI'm not 100% happy with a few things but I ran out of time & steam (and expertise) to address them.  If you got quick fixes then let me know, otherwise they might be left for another day.  \"Issues\" left:\r\n\r\n- description of `let` could use some love.  In particular it is not quite clear what the difference is between introducing variables in its head vs. body.\r\n- macros could probably do with an example and a link to the somewhat related topic of hygiene\r\n- section on \"Constants\" seems a bit out of place.  But where to move it?\r\n- running the doctests I got lots of errors from everywhere.  Is that expected because on my path is Julia-0.3?  Or are they indeed broken?\r\n\r\nCc'ing people from the issues and some of the original authors: @elextr , @uvtc, @JeffBezanson, @Sisyphuss, @nolta\r\n","created_at":"2015-07-14T19:36:30Z","updated_at":"2015-07-14T19:36:30Z","closed_at":null,"merged_at":null,"merge_commit_sha":null,"assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/JuliaLang/julia/pulls/12146/commits","review_comments_url":"https://api.github.com/repos/JuliaLang/julia/pulls/12146/comments","review_comment_url":"https://api.github.com/repos/JuliaLang/julia/pulls/comments{/number}","comments_url":"https://api.github.com/repos/JuliaLang/julia/issues/12146/comments","statuses_url":"https://api.github.com/repos/JuliaLang/julia/statuses/41911d96d86397168ade1f39914a8d7ed1653558","head":{"label":"mauro3:m3/scope-doc","ref":"m3/scope-doc","sha":"41911d96d86397168ade1f39914a8d7ed1653558","user":{"login":"mauro3","id":4098145,"avatar_url":"https://avatars.githubusercontent.com/u/4098145?v=3","gravatar_id":"","url":"https://api.github.com/users/mauro3","html_url":"https://github.com/mauro3","followers_url":"https://api.github.com/users/mauro3/followers","following_url":"https://api.github.com/users/mauro3/following{/other_user}","gists_url":"https://api.github.com/users/mauro3/gists{/gist_id}","starred_url":"https://api.github.com/users/mauro3/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mauro3/subscriptions","organizations_url":"https://api.github.com/users/mauro3/orgs","repos_url":"https://api.github.com/users/mauro3/repos","events_url":"https://api.github.com/users/mauro3/events{/privacy}","received_events_url":"https://api.github.com/users/mauro3/received_events","type":"User","site_admin":false},"repo":{"id":15839999,"name":"julia","full_name":"mauro3/julia","owner":{"login":"mauro3","id":4098145,"avatar_url":"https://avatars.githubusercontent.com/u/4098145?v=3","gravatar_id":"","url":"https://api.github.com/users/mauro3","html_url":"https://github.com/mauro3","followers_url":"https://api.github.com/users/mauro3/followers","following_url":"https://api.github.com/users/mauro3/following{/other_user}","gists_url":"https://api.github.com/users/mauro3/gists{/gist_id}","starred_url":"https://api.github.com/users/mauro3/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mauro3/subscriptions","organizations_url":"https://api.github.com/users/mauro3/orgs","repos_url":"https://api.github.com/users/mauro3/repos","events_url":"https://api.github.com/users/mauro3/events{/privacy}","received_events_url":"https://api.github.com/users/mauro3/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/mauro3/julia","description":"The Julia Language: A fresh approach to technical computing.","fork":true,"url":"https://api.github.com/repos/mauro3/julia","forks_url":"https://api.github.com/repos/mauro3/julia/forks","keys_url":"https://api.github.com/repos/mauro3/julia/keys{/key_id}","collaborators_url":"https://api.github.com/repos/mauro3/julia/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/mauro3/julia/teams","hooks_url":"https://api.github.com/repos/mauro3/julia/hooks","issue_events_url":"https://api.github.com/repos/mauro3/julia/issues/events{/number}","events_url":"https://api.github.com/repos/mauro3/julia/events","assignees_url":"https://api.github.com/repos/mauro3/julia/assignees{/user}","branches_url":"https://api.github.com/repos/mauro3/julia/branches{/branch}","tags_url":"https://api.github.com/repos/mauro3/julia/tags","blobs_url":"https://api.github.com/repos/mauro3/julia/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/mauro3/julia/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/mauro3/julia/git/refs{/sha}","trees_url":"https://api.github.com/repos/mauro3/julia/git/trees{/sha}","statuses_url":"https://api.github.com/repos/mauro3/julia/statuses/{sha}","languages_url":"https://api.github.com/repos/mauro3/julia/languages","stargazers_url":"https://api.github.com/repos/mauro3/julia/stargazers","contributors_url":"https://api.github.com/repos/mauro3/julia/contributors","subscribers_url":"https://api.github.com/repos/mauro3/julia/subscribers","subscription_url":"https://api.github.com/repos/mauro3/julia/subscription","commits_url":"https://api.github.com/repos/mauro3/julia/commits{/sha}","git_commits_url":"https://api.github.com/repos/mauro3/julia/git/commits{/sha}","comments_url":"https://api.github.com/repos/mauro3/julia/comments{/number}","issue_comment_url":"https://api.github.com/repos/mauro3/julia/issues/comments{/number}","contents_url":"https://api.github.com/repos/mauro3/julia/contents/{+path}","compare_url":"https://api.github.com/repos/mauro3/julia/compare/{base}...{head}","merges_url":"https://api.github.com/repos/mauro3/julia/merges","archive_url":"https://api.github.com/repos/mauro3/julia/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/mauro3/julia/downloads","issues_url":"https://api.github.com/repos/mauro3/julia/issues{/number}","pulls_url":"https://api.github.com/repos/mauro3/julia/pulls{/number}","milestones_url":"https://api.github.com/repos/mauro3/julia/milestones{/number}","notifications_url":"https://api.github.com/repos/mauro3/julia/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/mauro3/julia/labels{/name}","releases_url":"https://api.github.com/repos/mauro3/julia/releases{/id}","created_at":"2014-01-12T10:03:39Z","updated_at":"2015-04-22T08:32:13Z","pushed_at":"2015-07-14T19:18:19Z","git_url":"git://github.com/mauro3/julia.git","ssh_url":"git@github.com:mauro3/julia.git","clone_url":"https://github.com/mauro3/julia.git","svn_url":"https://github.com/mauro3/julia","homepage":"http://julialang.org/","size":72800,"stargazers_count":0,"watchers_count":0,"language":"Julia","has_issues":false,"has_downloads":true,"has_wiki":false,"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":"JuliaLang:master","ref":"master","sha":"3c8d0fb6a0bb26eed70ee1c79704c49bbdb3a793","user":{"login":"JuliaLang","id":743164,"avatar_url":"https://avatars.githubusercontent.com/u/743164?v=3","gravatar_id":"","url":"https://api.github.com/users/JuliaLang","html_url":"https://github.com/JuliaLang","followers_url":"https://api.github.com/users/JuliaLang/followers","following_url":"https://api.github.com/users/JuliaLang/following{/other_user}","gists_url":"https://api.github.com/users/JuliaLang/gists{/gist_id}","starred_url":"https://api.github.com/users/JuliaLang/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/JuliaLang/subscriptions","organizations_url":"https://api.github.com/users/JuliaLang/orgs","repos_url":"https://api.github.com/users/JuliaLang/repos","events_url":"https://api.github.com/users/JuliaLang/events{/privacy}","received_events_url":"https://api.github.com/users/JuliaLang/received_events","type":"Organization","site_admin":false},"repo":{"id":1644196,"name":"julia","full_name":"JuliaLang/julia","owner":{"login":"JuliaLang","id":743164,"avatar_url":"https://avatars.githubusercontent.com/u/743164?v=3","gravatar_id":"","url":"https://api.github.com/users/JuliaLang","html_url":"https://github.com/JuliaLang","followers_url":"https://api.github.com/users/JuliaLang/followers","following_url":"https://api.github.com/users/JuliaLang/following{/other_user}","gists_url":"https://api.github.com/users/JuliaLang/gists{/gist_id}","starred_url":"https://api.github.com/users/JuliaLang/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/JuliaLang/subscriptions","organizations_url":"https://api.github.com/users/JuliaLang/orgs","repos_url":"https://api.github.com/users/JuliaLang/repos","events_url":"https://api.github.com/users/JuliaLang/events{/privacy}","received_events_url":"https://api.github.com/users/JuliaLang/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/JuliaLang/julia","description":"The Julia Language: A fresh approach to technical computing.","fork":false,"url":"https://api.github.com/repos/JuliaLang/julia","forks_url":"https://api.github.com/repos/JuliaLang/julia/forks","keys_url":"https://api.github.com/repos/JuliaLang/julia/keys{/key_id}","collaborators_url":"https://api.github.com/repos/JuliaLang/julia/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/JuliaLang/julia/teams","hooks_url":"https://api.github.com/repos/JuliaLang/julia/hooks","issue_events_url":"https://api.github.com/repos/JuliaLang/julia/issues/events{/number}","events_url":"https://api.github.com/repos/JuliaLang/julia/events","assignees_url":"https://api.github.com/repos/JuliaLang/julia/assignees{/user}","branches_url":"https://api.github.com/repos/JuliaLang/julia/branches{/branch}","tags_url":"https://api.github.com/repos/JuliaLang/julia/tags","blobs_url":"https://api.github.com/repos/JuliaLang/julia/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/JuliaLang/julia/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/JuliaLang/julia/git/refs{/sha}","trees_url":"https://api.github.com/repos/JuliaLang/julia/git/trees{/sha}","statuses_url":"https://api.github.com/repos/JuliaLang/julia/statuses/{sha}","languages_url":"https://api.github.com/repos/JuliaLang/julia/languages","stargazers_url":"https://api.github.com/repos/JuliaLang/julia/stargazers","contributors_url":"https://api.github.com/repos/JuliaLang/julia/contributors","subscribers_url":"https://api.github.com/repos/JuliaLang/julia/subscribers","subscription_url":"https://api.github.com/repos/JuliaLang/julia/subscription","commits_url":"https://api.github.com/repos/JuliaLang/julia/commits{/sha}","git_commits_url":"https://api.github.com/repos/JuliaLang/julia/git/commits{/sha}","comments_url":"https://api.github.com/repos/JuliaLang/julia/comments{/number}","issue_comment_url":"https://api.github.com/repos/JuliaLang/julia/issues/comments{/number}","contents_url":"https://api.github.com/repos/JuliaLang/julia/contents/{+path}","compare_url":"https://api.github.com/repos/JuliaLang/julia/compare/{base}...{head}","merges_url":"https://api.github.com/repos/JuliaLang/julia/merges","archive_url":"https://api.github.com/repos/JuliaLang/julia/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/JuliaLang/julia/downloads","issues_url":"https://api.github.com/repos/JuliaLang/julia/issues{/number}","pulls_url":"https://api.github.com/repos/JuliaLang/julia/pulls{/number}","milestones_url":"https://api.github.com/repos/JuliaLang/julia/milestones{/number}","notifications_url":"https://api.github.com/repos/JuliaLang/julia/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/JuliaLang/julia/labels{/name}","releases_url":"https://api.github.com/repos/JuliaLang/julia/releases{/id}","created_at":"2011-04-21T07:01:50Z","updated_at":"2015-07-14T08:41:44Z","pushed_at":"2015-07-14T19:11:55Z","git_url":"git://github.com/JuliaLang/julia.git","ssh_url":"git@github.com:JuliaLang/julia.git","clone_url":"https://github.com/JuliaLang/julia.git","svn_url":"https://github.com/JuliaLang/julia","homepage":"http://julialang.org/","size":200400,"stargazers_count":5762,"watchers_count":5762,"language":"Julia","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":1234,"mirror_url":null,"open_issues_count":1337,"forks":1234,"open_issues":1337,"watchers":5762,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/JuliaLang/julia/pulls/12146"},"html":{"href":"https://github.com/JuliaLang/julia/pull/12146"},"issue":{"href":"https://api.github.com/repos/JuliaLang/julia/issues/12146"},"comments":{"href":"https://api.github.com/repos/JuliaLang/julia/issues/12146/comments"},"review_comments":{"href":"https://api.github.com/repos/JuliaLang/julia/pulls/12146/comments"},"review_comment":{"href":"https://api.github.com/repos/JuliaLang/julia/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/JuliaLang/julia/pulls/12146/commits"},"statuses":{"href":"https://api.github.com/repos/JuliaLang/julia/statuses/41911d96d86397168ade1f39914a8d7ed1653558"}},"merged":false,"mergeable":null,"mergeable_state":"unknown","merged_by":null,"comments":0,"review_comments":0,"commits":1,"additions":309,"deletions":185,"changed_files":4}}