{"action":"created","comment":{"url":"https://api.github.com/repos/racket/racket/pulls/comments/61940891","id":61940891,"diff_hunk":"@@ -923,11 +923,48 @@ definition context.\n \n @defproc[(syntax-local-introduce [stx syntax?]) syntax?]{\n \n-Produces a syntax object that is like @racket[stx], except that the\n-presence of @tech{scopes} for the current expansion---both the\n-macro-introduction scope and the use-site scope, if any---is flipped\n-on all parts of the syntax object. See @secref[\"transformer-model\"] for information\n-on macro-introduction and use-site @tech{scopes}.\n+Produces a syntax object that is like @racket[stx], but with a new \n+@tech{scope} added that flips the apparent introduction site for all \n+parts of the syntax object. Meaning, parts of the syntax object that \n+start with a macro-introduction scope will end up with a use-site scope, \n+and vice versa. (See @secref[\"transformer-model\"] for information on \n+macro-introduction and use-site @tech{scopes}.)\n+\n+Consistent with its name, this procedure is commonly used to introduce \n+an unhygienic binding at the use site, by making a macro-introduced \n+binding appear as if it came from the use site. It is important, however, \n+that the syntax object passed to @racket[syntax-local-introduce] be free \n+of any extraneous scopes. Otherwise, the behavior of the introduced \n+identifier can be unpredictable. Using @racket[(datum->syntax #f _id)] \n+to prepare the input syntax is good policy.","path":"pkgs/racket-doc/scribblings/reference/stx-trans.scrbl","position":22,"original_position":22,"commit_id":"2f6e144ae4468adf3a56f31808573709433a3d13","original_commit_id":"2f6e144ae4468adf3a56f31808573709433a3d13","user":{"login":"mbutterick","id":1425051,"avatar_url":"https://avatars.githubusercontent.com/u/1425051?v=3","gravatar_id":"","url":"https://api.github.com/users/mbutterick","html_url":"https://github.com/mbutterick","followers_url":"https://api.github.com/users/mbutterick/followers","following_url":"https://api.github.com/users/mbutterick/following{/other_user}","gists_url":"https://api.github.com/users/mbutterick/gists{/gist_id}","starred_url":"https://api.github.com/users/mbutterick/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mbutterick/subscriptions","organizations_url":"https://api.github.com/users/mbutterick/orgs","repos_url":"https://api.github.com/users/mbutterick/repos","events_url":"https://api.github.com/users/mbutterick/events{/privacy}","received_events_url":"https://api.github.com/users/mbutterick/received_events","type":"User","site_admin":false},"body":"The whole premise of this pull request is that I don't understand what this function does. We can therefore agree that I'm unqualified to document it ;)","created_at":"2016-05-03T19:29:32Z","updated_at":"2016-05-03T19:29:32Z","html_url":"https://github.com/racket/racket/pull/1321#discussion_r61940891","pull_request_url":"https://api.github.com/repos/racket/racket/pulls/1321","_links":{"self":{"href":"https://api.github.com/repos/racket/racket/pulls/comments/61940891"},"html":{"href":"https://github.com/racket/racket/pull/1321#discussion_r61940891"},"pull_request":{"href":"https://api.github.com/repos/racket/racket/pulls/1321"}}},"pull_request":{"url":"https://api.github.com/repos/racket/racket/pulls/1321","id":68731011,"html_url":"https://github.com/racket/racket/pull/1321","diff_url":"https://github.com/racket/racket/pull/1321.diff","patch_url":"https://github.com/racket/racket/pull/1321.patch","issue_url":"https://api.github.com/repos/racket/racket/issues/1321","number":1321,"state":"open","locked":false,"title":"expand docs for `syntax-local-introduce`","user":{"login":"mbutterick","id":1425051,"avatar_url":"https://avatars.githubusercontent.com/u/1425051?v=3","gravatar_id":"","url":"https://api.github.com/users/mbutterick","html_url":"https://github.com/mbutterick","followers_url":"https://api.github.com/users/mbutterick/followers","following_url":"https://api.github.com/users/mbutterick/following{/other_user}","gists_url":"https://api.github.com/users/mbutterick/gists{/gist_id}","starred_url":"https://api.github.com/users/mbutterick/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mbutterick/subscriptions","organizations_url":"https://api.github.com/users/mbutterick/orgs","repos_url":"https://api.github.com/users/mbutterick/repos","events_url":"https://api.github.com/users/mbutterick/events{/privacy}","received_events_url":"https://api.github.com/users/mbutterick/received_events","type":"User","site_admin":false},"body":"Add more detailed explanation, and code sample showing characteristic use.","created_at":"2016-05-03T16:05:17Z","updated_at":"2016-05-03T19:29:32Z","closed_at":null,"merged_at":null,"merge_commit_sha":"f0ef12d6700171e0270881d7116bcfa3fd94e02f","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/racket/racket/pulls/1321/commits","review_comments_url":"https://api.github.com/repos/racket/racket/pulls/1321/comments","review_comment_url":"https://api.github.com/repos/racket/racket/pulls/comments{/number}","comments_url":"https://api.github.com/repos/racket/racket/issues/1321/comments","statuses_url":"https://api.github.com/repos/racket/racket/statuses/2f6e144ae4468adf3a56f31808573709433a3d13","head":{"label":"mbutterick:sli-doc-update","ref":"sli-doc-update","sha":"2f6e144ae4468adf3a56f31808573709433a3d13","user":{"login":"mbutterick","id":1425051,"avatar_url":"https://avatars.githubusercontent.com/u/1425051?v=3","gravatar_id":"","url":"https://api.github.com/users/mbutterick","html_url":"https://github.com/mbutterick","followers_url":"https://api.github.com/users/mbutterick/followers","following_url":"https://api.github.com/users/mbutterick/following{/other_user}","gists_url":"https://api.github.com/users/mbutterick/gists{/gist_id}","starred_url":"https://api.github.com/users/mbutterick/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mbutterick/subscriptions","organizations_url":"https://api.github.com/users/mbutterick/orgs","repos_url":"https://api.github.com/users/mbutterick/repos","events_url":"https://api.github.com/users/mbutterick/events{/privacy}","received_events_url":"https://api.github.com/users/mbutterick/received_events","type":"User","site_admin":false},"repo":{"id":14412264,"name":"racket","full_name":"mbutterick/racket","owner":{"login":"mbutterick","id":1425051,"avatar_url":"https://avatars.githubusercontent.com/u/1425051?v=3","gravatar_id":"","url":"https://api.github.com/users/mbutterick","html_url":"https://github.com/mbutterick","followers_url":"https://api.github.com/users/mbutterick/followers","following_url":"https://api.github.com/users/mbutterick/following{/other_user}","gists_url":"https://api.github.com/users/mbutterick/gists{/gist_id}","starred_url":"https://api.github.com/users/mbutterick/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mbutterick/subscriptions","organizations_url":"https://api.github.com/users/mbutterick/orgs","repos_url":"https://api.github.com/users/mbutterick/repos","events_url":"https://api.github.com/users/mbutterick/events{/privacy}","received_events_url":"https://api.github.com/users/mbutterick/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/mbutterick/racket","description":"The Racket repository","fork":true,"url":"https://api.github.com/repos/mbutterick/racket","forks_url":"https://api.github.com/repos/mbutterick/racket/forks","keys_url":"https://api.github.com/repos/mbutterick/racket/keys{/key_id}","collaborators_url":"https://api.github.com/repos/mbutterick/racket/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/mbutterick/racket/teams","hooks_url":"https://api.github.com/repos/mbutterick/racket/hooks","issue_events_url":"https://api.github.com/repos/mbutterick/racket/issues/events{/number}","events_url":"https://api.github.com/repos/mbutterick/racket/events","assignees_url":"https://api.github.com/repos/mbutterick/racket/assignees{/user}","branches_url":"https://api.github.com/repos/mbutterick/racket/branches{/branch}","tags_url":"https://api.github.com/repos/mbutterick/racket/tags","blobs_url":"https://api.github.com/repos/mbutterick/racket/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/mbutterick/racket/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/mbutterick/racket/git/refs{/sha}","trees_url":"https://api.github.com/repos/mbutterick/racket/git/trees{/sha}","statuses_url":"https://api.github.com/repos/mbutterick/racket/statuses/{sha}","languages_url":"https://api.github.com/repos/mbutterick/racket/languages","stargazers_url":"https://api.github.com/repos/mbutterick/racket/stargazers","contributors_url":"https://api.github.com/repos/mbutterick/racket/contributors","subscribers_url":"https://api.github.com/repos/mbutterick/racket/subscribers","subscription_url":"https://api.github.com/repos/mbutterick/racket/subscription","commits_url":"https://api.github.com/repos/mbutterick/racket/commits{/sha}","git_commits_url":"https://api.github.com/repos/mbutterick/racket/git/commits{/sha}","comments_url":"https://api.github.com/repos/mbutterick/racket/comments{/number}","issue_comment_url":"https://api.github.com/repos/mbutterick/racket/issues/comments{/number}","contents_url":"https://api.github.com/repos/mbutterick/racket/contents/{+path}","compare_url":"https://api.github.com/repos/mbutterick/racket/compare/{base}...{head}","merges_url":"https://api.github.com/repos/mbutterick/racket/merges","archive_url":"https://api.github.com/repos/mbutterick/racket/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/mbutterick/racket/downloads","issues_url":"https://api.github.com/repos/mbutterick/racket/issues{/number}","pulls_url":"https://api.github.com/repos/mbutterick/racket/pulls{/number}","milestones_url":"https://api.github.com/repos/mbutterick/racket/milestones{/number}","notifications_url":"https://api.github.com/repos/mbutterick/racket/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/mbutterick/racket/labels{/name}","releases_url":"https://api.github.com/repos/mbutterick/racket/releases{/id}","deployments_url":"https://api.github.com/repos/mbutterick/racket/deployments","created_at":"2013-11-15T01:45:37Z","updated_at":"2015-07-23T15:54:54Z","pushed_at":"2016-05-03T17:42:17Z","git_url":"git://github.com/mbutterick/racket.git","ssh_url":"git@github.com:mbutterick/racket.git","clone_url":"https://github.com/mbutterick/racket.git","svn_url":"https://github.com/mbutterick/racket","homepage":"http://racket-lang.org/","size":162743,"stargazers_count":0,"watchers_count":0,"language":"Racket","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":"racket:master","ref":"master","sha":"9d3c193bcfee82072a88556999e3670306461a34","user":{"login":"racket","id":232371,"avatar_url":"https://avatars.githubusercontent.com/u/232371?v=3","gravatar_id":"","url":"https://api.github.com/users/racket","html_url":"https://github.com/racket","followers_url":"https://api.github.com/users/racket/followers","following_url":"https://api.github.com/users/racket/following{/other_user}","gists_url":"https://api.github.com/users/racket/gists{/gist_id}","starred_url":"https://api.github.com/users/racket/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/racket/subscriptions","organizations_url":"https://api.github.com/users/racket/orgs","repos_url":"https://api.github.com/users/racket/repos","events_url":"https://api.github.com/users/racket/events{/privacy}","received_events_url":"https://api.github.com/users/racket/received_events","type":"Organization","site_admin":false},"repo":{"id":615969,"name":"racket","full_name":"racket/racket","owner":{"login":"racket","id":232371,"avatar_url":"https://avatars.githubusercontent.com/u/232371?v=3","gravatar_id":"","url":"https://api.github.com/users/racket","html_url":"https://github.com/racket","followers_url":"https://api.github.com/users/racket/followers","following_url":"https://api.github.com/users/racket/following{/other_user}","gists_url":"https://api.github.com/users/racket/gists{/gist_id}","starred_url":"https://api.github.com/users/racket/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/racket/subscriptions","organizations_url":"https://api.github.com/users/racket/orgs","repos_url":"https://api.github.com/users/racket/repos","events_url":"https://api.github.com/users/racket/events{/privacy}","received_events_url":"https://api.github.com/users/racket/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/racket/racket","description":"The Racket repository","fork":false,"url":"https://api.github.com/repos/racket/racket","forks_url":"https://api.github.com/repos/racket/racket/forks","keys_url":"https://api.github.com/repos/racket/racket/keys{/key_id}","collaborators_url":"https://api.github.com/repos/racket/racket/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/racket/racket/teams","hooks_url":"https://api.github.com/repos/racket/racket/hooks","issue_events_url":"https://api.github.com/repos/racket/racket/issues/events{/number}","events_url":"https://api.github.com/repos/racket/racket/events","assignees_url":"https://api.github.com/repos/racket/racket/assignees{/user}","branches_url":"https://api.github.com/repos/racket/racket/branches{/branch}","tags_url":"https://api.github.com/repos/racket/racket/tags","blobs_url":"https://api.github.com/repos/racket/racket/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/racket/racket/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/racket/racket/git/refs{/sha}","trees_url":"https://api.github.com/repos/racket/racket/git/trees{/sha}","statuses_url":"https://api.github.com/repos/racket/racket/statuses/{sha}","languages_url":"https://api.github.com/repos/racket/racket/languages","stargazers_url":"https://api.github.com/repos/racket/racket/stargazers","contributors_url":"https://api.github.com/repos/racket/racket/contributors","subscribers_url":"https://api.github.com/repos/racket/racket/subscribers","subscription_url":"https://api.github.com/repos/racket/racket/subscription","commits_url":"https://api.github.com/repos/racket/racket/commits{/sha}","git_commits_url":"https://api.github.com/repos/racket/racket/git/commits{/sha}","comments_url":"https://api.github.com/repos/racket/racket/comments{/number}","issue_comment_url":"https://api.github.com/repos/racket/racket/issues/comments{/number}","contents_url":"https://api.github.com/repos/racket/racket/contents/{+path}","compare_url":"https://api.github.com/repos/racket/racket/compare/{base}...{head}","merges_url":"https://api.github.com/repos/racket/racket/merges","archive_url":"https://api.github.com/repos/racket/racket/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/racket/racket/downloads","issues_url":"https://api.github.com/repos/racket/racket/issues{/number}","pulls_url":"https://api.github.com/repos/racket/racket/pulls{/number}","milestones_url":"https://api.github.com/repos/racket/racket/milestones{/number}","notifications_url":"https://api.github.com/repos/racket/racket/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/racket/racket/labels{/name}","releases_url":"https://api.github.com/repos/racket/racket/releases{/id}","deployments_url":"https://api.github.com/repos/racket/racket/deployments","created_at":"2010-04-18T06:39:16Z","updated_at":"2016-05-02T11:11:23Z","pushed_at":"2016-05-03T17:42:17Z","git_url":"git://github.com/racket/racket.git","ssh_url":"git@github.com:racket/racket.git","clone_url":"https://github.com/racket/racket.git","svn_url":"https://github.com/racket/racket","homepage":"https://racket-lang.org/","size":188760,"stargazers_count":1438,"watchers_count":1438,"language":"Racket","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":295,"mirror_url":null,"open_issues_count":90,"forks":295,"open_issues":90,"watchers":1438,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/racket/racket/pulls/1321"},"html":{"href":"https://github.com/racket/racket/pull/1321"},"issue":{"href":"https://api.github.com/repos/racket/racket/issues/1321"},"comments":{"href":"https://api.github.com/repos/racket/racket/issues/1321/comments"},"review_comments":{"href":"https://api.github.com/repos/racket/racket/pulls/1321/comments"},"review_comment":{"href":"https://api.github.com/repos/racket/racket/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/racket/racket/pulls/1321/commits"},"statuses":{"href":"https://api.github.com/repos/racket/racket/statuses/2f6e144ae4468adf3a56f31808573709433a3d13"}}}}