{"action":"created","comment":{"url":"https://api.github.com/repos/livecode/livecode/pulls/comments/59622908","id":59622908,"diff_hunk":"@@ -43,27 +44,45 @@ on textRead\n end textRead\n \n Description:\n-Use the <URL> <keyword> to access the contents of a local <file> or a <file> accessible on the Web.\n-\n-A <URL> is a method of designating a file or other resource. You can use a <URL> like any other container.\n-You can get the contents of a <URL> or use its contents in any expression. LiveCode supports the following <URL> schemes: \n-\n-* http: a page from a web server\n-* ftp: a directory or file on an FTP server\n-* file: a text file on the local disk (not on a server)\n-* binfile: a binary file\n-* resfile: on Mac OS and OS X systems, the resource fork of a file\n-\n-All actions that refer to a <URL> container are blocking: that is, the handler pauses until LiveCode is finished accessing the <URL>. Since fetching a web page may take some time due to network lag, accessing URLs may take long enough to be noticeable to the user. To avoid this delay, use the load command (which is non-blocking) to cache web pages before you need them.\n-\n-For technical information about URLs and URL schemes, see [RFC 1630](https://tools.ietf.org/html/rfc1630).\n-\n->*Important:*  The http and ftp keywords are part of the Internet library on desktop platforms. To ensure that these <URL> types work in a desktop standalone application, you must include this custom library when you create your standalone. In the Inclusions section of the Standalone Application Settings window, make sure Internet Library is selected in the list of script libraries. The iOS and Android engines do not support 'libUrl' but allow you to use <URL>. When specifying URLs for iOS and Android, you must use the appropriate form that confirms to RFC 1630. Ensure that you urlEncode any username and password fields appropriately for FTP urls.\n-\n->*Important:*  The space character is not valid in URLs, however libURL (Desktop platforms) replaces this character with the required '%20'. This is something that the mobile and server platforms do not do. Be careful to construct valid URLs when working an fully cross platform applications.\n-\n-From LiveCode 7.0.0, URL keyword has been upgraded to understand Unicode files when using URL(\"file:\"). If the file located at the path has a Byte Order Mark at its beginning, then URL will decode the file according to that Byte Order Mark (UTF-8, UTF-16BE, UTF-16LE, UTF-32BE and UTF-32LE are compatible). If no Byte Order Mark is found, then the file will be decoded as if it were using Native encoding (MacRoman on Mac OS X, ISO-8859-1 on Linux, CP-1252 on Windows).\n-\n-References: HTMLText (property), URL (keyword), file (keyword), libURLSetAuthCallback (command), launch url (command), libURLSetExpect100 (command), load (command), container (glossary), keyword (glossary), resource (glossary)\n+Use the <URL(keyword)> <keyword> to access the contents of a <file|local file> or a <file> accessible on the Web.","path":"docs/dictionary/keyword/URL.lcdoc","position":43,"original_position":43,"commit_id":"70b00e2fc06b2de5891b391fb4ffea8b64caff14","original_commit_id":"70b00e2fc06b2de5891b391fb4ffea8b64caff14","user":{"login":"livecodeali","id":3985854,"avatar_url":"https://avatars.githubusercontent.com/u/3985854?v=3","gravatar_id":"","url":"https://api.github.com/users/livecodeali","html_url":"https://github.com/livecodeali","followers_url":"https://api.github.com/users/livecodeali/followers","following_url":"https://api.github.com/users/livecodeali/following{/other_user}","gists_url":"https://api.github.com/users/livecodeali/gists{/gist_id}","starred_url":"https://api.github.com/users/livecodeali/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/livecodeali/subscriptions","organizations_url":"https://api.github.com/users/livecodeali/orgs","repos_url":"https://api.github.com/users/livecodeali/repos","events_url":"https://api.github.com/users/livecodeali/events{/privacy}","received_events_url":"https://api.github.com/users/livecodeali/received_events","type":"User","site_admin":false},"body":"There's actually a `<local file>` glossary entry - this should probably link to that instead","created_at":"2016-04-13T20:50:03Z","updated_at":"2016-04-13T20:50:03Z","html_url":"https://github.com/livecode/livecode/pull/3919#discussion_r59622908","pull_request_url":"https://api.github.com/repos/livecode/livecode/pulls/3919","_links":{"self":{"href":"https://api.github.com/repos/livecode/livecode/pulls/comments/59622908"},"html":{"href":"https://github.com/livecode/livecode/pull/3919#discussion_r59622908"},"pull_request":{"href":"https://api.github.com/repos/livecode/livecode/pulls/3919"}}},"pull_request":{"url":"https://api.github.com/repos/livecode/livecode/pulls/3919","id":66380513,"html_url":"https://github.com/livecode/livecode/pull/3919","diff_url":"https://github.com/livecode/livecode/pull/3919.diff","patch_url":"https://github.com/livecode/livecode/pull/3919.patch","issue_url":"https://api.github.com/repos/livecode/livecode/issues/3919","number":3919,"state":"open","locked":false,"title":"[[ Community Docs ]] URL Keyword enhancements","user":{"login":"asayd","id":9824298,"avatar_url":"https://avatars.githubusercontent.com/u/9824298?v=3","gravatar_id":"","url":"https://api.github.com/users/asayd","html_url":"https://github.com/asayd","followers_url":"https://api.github.com/users/asayd/followers","following_url":"https://api.github.com/users/asayd/following{/other_user}","gists_url":"https://api.github.com/users/asayd/gists{/gist_id}","starred_url":"https://api.github.com/users/asayd/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/asayd/subscriptions","organizations_url":"https://api.github.com/users/asayd/orgs","repos_url":"https://api.github.com/users/asayd/repos","events_url":"https://api.github.com/users/asayd/events{/privacy}","received_events_url":"https://api.github.com/users/asayd/received_events","type":"User","site_admin":false},"body":"- Added references;\r\n- Added links;\r\n- Fixed typos.","created_at":"2016-04-13T19:50:05Z","updated_at":"2016-04-13T20:50:03Z","closed_at":null,"merged_at":null,"merge_commit_sha":"0e084c8eadbd3bbff67dfa2751a70d9120549c0b","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/livecode/livecode/pulls/3919/commits","review_comments_url":"https://api.github.com/repos/livecode/livecode/pulls/3919/comments","review_comment_url":"https://api.github.com/repos/livecode/livecode/pulls/comments{/number}","comments_url":"https://api.github.com/repos/livecode/livecode/issues/3919/comments","statuses_url":"https://api.github.com/repos/livecode/livecode/statuses/70b00e2fc06b2de5891b391fb4ffea8b64caff14","head":{"label":"asayd:patch-4","ref":"patch-4","sha":"70b00e2fc06b2de5891b391fb4ffea8b64caff14","user":{"login":"asayd","id":9824298,"avatar_url":"https://avatars.githubusercontent.com/u/9824298?v=3","gravatar_id":"","url":"https://api.github.com/users/asayd","html_url":"https://github.com/asayd","followers_url":"https://api.github.com/users/asayd/followers","following_url":"https://api.github.com/users/asayd/following{/other_user}","gists_url":"https://api.github.com/users/asayd/gists{/gist_id}","starred_url":"https://api.github.com/users/asayd/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/asayd/subscriptions","organizations_url":"https://api.github.com/users/asayd/orgs","repos_url":"https://api.github.com/users/asayd/repos","events_url":"https://api.github.com/users/asayd/events{/privacy}","received_events_url":"https://api.github.com/users/asayd/received_events","type":"User","site_admin":false},"repo":{"id":55647616,"name":"livecode","full_name":"asayd/livecode","owner":{"login":"asayd","id":9824298,"avatar_url":"https://avatars.githubusercontent.com/u/9824298?v=3","gravatar_id":"","url":"https://api.github.com/users/asayd","html_url":"https://github.com/asayd","followers_url":"https://api.github.com/users/asayd/followers","following_url":"https://api.github.com/users/asayd/following{/other_user}","gists_url":"https://api.github.com/users/asayd/gists{/gist_id}","starred_url":"https://api.github.com/users/asayd/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/asayd/subscriptions","organizations_url":"https://api.github.com/users/asayd/orgs","repos_url":"https://api.github.com/users/asayd/repos","events_url":"https://api.github.com/users/asayd/events{/privacy}","received_events_url":"https://api.github.com/users/asayd/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/asayd/livecode","description":"LiveCode cross-platform development environment (engine)","fork":true,"url":"https://api.github.com/repos/asayd/livecode","forks_url":"https://api.github.com/repos/asayd/livecode/forks","keys_url":"https://api.github.com/repos/asayd/livecode/keys{/key_id}","collaborators_url":"https://api.github.com/repos/asayd/livecode/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/asayd/livecode/teams","hooks_url":"https://api.github.com/repos/asayd/livecode/hooks","issue_events_url":"https://api.github.com/repos/asayd/livecode/issues/events{/number}","events_url":"https://api.github.com/repos/asayd/livecode/events","assignees_url":"https://api.github.com/repos/asayd/livecode/assignees{/user}","branches_url":"https://api.github.com/repos/asayd/livecode/branches{/branch}","tags_url":"https://api.github.com/repos/asayd/livecode/tags","blobs_url":"https://api.github.com/repos/asayd/livecode/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/asayd/livecode/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/asayd/livecode/git/refs{/sha}","trees_url":"https://api.github.com/repos/asayd/livecode/git/trees{/sha}","statuses_url":"https://api.github.com/repos/asayd/livecode/statuses/{sha}","languages_url":"https://api.github.com/repos/asayd/livecode/languages","stargazers_url":"https://api.github.com/repos/asayd/livecode/stargazers","contributors_url":"https://api.github.com/repos/asayd/livecode/contributors","subscribers_url":"https://api.github.com/repos/asayd/livecode/subscribers","subscription_url":"https://api.github.com/repos/asayd/livecode/subscription","commits_url":"https://api.github.com/repos/asayd/livecode/commits{/sha}","git_commits_url":"https://api.github.com/repos/asayd/livecode/git/commits{/sha}","comments_url":"https://api.github.com/repos/asayd/livecode/comments{/number}","issue_comment_url":"https://api.github.com/repos/asayd/livecode/issues/comments{/number}","contents_url":"https://api.github.com/repos/asayd/livecode/contents/{+path}","compare_url":"https://api.github.com/repos/asayd/livecode/compare/{base}...{head}","merges_url":"https://api.github.com/repos/asayd/livecode/merges","archive_url":"https://api.github.com/repos/asayd/livecode/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/asayd/livecode/downloads","issues_url":"https://api.github.com/repos/asayd/livecode/issues{/number}","pulls_url":"https://api.github.com/repos/asayd/livecode/pulls{/number}","milestones_url":"https://api.github.com/repos/asayd/livecode/milestones{/number}","notifications_url":"https://api.github.com/repos/asayd/livecode/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/asayd/livecode/labels{/name}","releases_url":"https://api.github.com/repos/asayd/livecode/releases{/id}","deployments_url":"https://api.github.com/repos/asayd/livecode/deployments","created_at":"2016-04-06T23:09:58Z","updated_at":"2016-04-06T23:10:12Z","pushed_at":"2016-04-13T19:49:57Z","git_url":"git://github.com/asayd/livecode.git","ssh_url":"git@github.com:asayd/livecode.git","clone_url":"https://github.com/asayd/livecode.git","svn_url":"https://github.com/asayd/livecode","homepage":"https://livecode.com/","size":121109,"stargazers_count":0,"watchers_count":0,"language":"C++","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":"develop"}},"base":{"label":"livecode:community-docs","ref":"community-docs","sha":"8a3204f372b15c019ecd64c457506eba66a03c8a","user":{"login":"livecode","id":3985749,"avatar_url":"https://avatars.githubusercontent.com/u/3985749?v=3","gravatar_id":"","url":"https://api.github.com/users/livecode","html_url":"https://github.com/livecode","followers_url":"https://api.github.com/users/livecode/followers","following_url":"https://api.github.com/users/livecode/following{/other_user}","gists_url":"https://api.github.com/users/livecode/gists{/gist_id}","starred_url":"https://api.github.com/users/livecode/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/livecode/subscriptions","organizations_url":"https://api.github.com/users/livecode/orgs","repos_url":"https://api.github.com/users/livecode/repos","events_url":"https://api.github.com/users/livecode/events{/privacy}","received_events_url":"https://api.github.com/users/livecode/received_events","type":"Organization","site_admin":false},"repo":{"id":9334445,"name":"livecode","full_name":"livecode/livecode","owner":{"login":"livecode","id":3985749,"avatar_url":"https://avatars.githubusercontent.com/u/3985749?v=3","gravatar_id":"","url":"https://api.github.com/users/livecode","html_url":"https://github.com/livecode","followers_url":"https://api.github.com/users/livecode/followers","following_url":"https://api.github.com/users/livecode/following{/other_user}","gists_url":"https://api.github.com/users/livecode/gists{/gist_id}","starred_url":"https://api.github.com/users/livecode/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/livecode/subscriptions","organizations_url":"https://api.github.com/users/livecode/orgs","repos_url":"https://api.github.com/users/livecode/repos","events_url":"https://api.github.com/users/livecode/events{/privacy}","received_events_url":"https://api.github.com/users/livecode/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/livecode/livecode","description":"LiveCode cross-platform development environment (engine)","fork":false,"url":"https://api.github.com/repos/livecode/livecode","forks_url":"https://api.github.com/repos/livecode/livecode/forks","keys_url":"https://api.github.com/repos/livecode/livecode/keys{/key_id}","collaborators_url":"https://api.github.com/repos/livecode/livecode/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/livecode/livecode/teams","hooks_url":"https://api.github.com/repos/livecode/livecode/hooks","issue_events_url":"https://api.github.com/repos/livecode/livecode/issues/events{/number}","events_url":"https://api.github.com/repos/livecode/livecode/events","assignees_url":"https://api.github.com/repos/livecode/livecode/assignees{/user}","branches_url":"https://api.github.com/repos/livecode/livecode/branches{/branch}","tags_url":"https://api.github.com/repos/livecode/livecode/tags","blobs_url":"https://api.github.com/repos/livecode/livecode/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/livecode/livecode/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/livecode/livecode/git/refs{/sha}","trees_url":"https://api.github.com/repos/livecode/livecode/git/trees{/sha}","statuses_url":"https://api.github.com/repos/livecode/livecode/statuses/{sha}","languages_url":"https://api.github.com/repos/livecode/livecode/languages","stargazers_url":"https://api.github.com/repos/livecode/livecode/stargazers","contributors_url":"https://api.github.com/repos/livecode/livecode/contributors","subscribers_url":"https://api.github.com/repos/livecode/livecode/subscribers","subscription_url":"https://api.github.com/repos/livecode/livecode/subscription","commits_url":"https://api.github.com/repos/livecode/livecode/commits{/sha}","git_commits_url":"https://api.github.com/repos/livecode/livecode/git/commits{/sha}","comments_url":"https://api.github.com/repos/livecode/livecode/comments{/number}","issue_comment_url":"https://api.github.com/repos/livecode/livecode/issues/comments{/number}","contents_url":"https://api.github.com/repos/livecode/livecode/contents/{+path}","compare_url":"https://api.github.com/repos/livecode/livecode/compare/{base}...{head}","merges_url":"https://api.github.com/repos/livecode/livecode/merges","archive_url":"https://api.github.com/repos/livecode/livecode/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/livecode/livecode/downloads","issues_url":"https://api.github.com/repos/livecode/livecode/issues{/number}","pulls_url":"https://api.github.com/repos/livecode/livecode/pulls{/number}","milestones_url":"https://api.github.com/repos/livecode/livecode/milestones{/number}","notifications_url":"https://api.github.com/repos/livecode/livecode/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/livecode/livecode/labels{/name}","releases_url":"https://api.github.com/repos/livecode/livecode/releases{/id}","deployments_url":"https://api.github.com/repos/livecode/livecode/deployments","created_at":"2013-04-10T00:15:57Z","updated_at":"2016-04-13T05:39:23Z","pushed_at":"2016-04-13T19:50:06Z","git_url":"git://github.com/livecode/livecode.git","ssh_url":"git@github.com:livecode/livecode.git","clone_url":"https://github.com/livecode/livecode.git","svn_url":"https://github.com/livecode/livecode","homepage":"https://livecode.com/","size":144622,"stargazers_count":112,"watchers_count":112,"language":"C++","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":95,"mirror_url":null,"open_issues_count":56,"forks":95,"open_issues":56,"watchers":112,"default_branch":"develop"}},"_links":{"self":{"href":"https://api.github.com/repos/livecode/livecode/pulls/3919"},"html":{"href":"https://github.com/livecode/livecode/pull/3919"},"issue":{"href":"https://api.github.com/repos/livecode/livecode/issues/3919"},"comments":{"href":"https://api.github.com/repos/livecode/livecode/issues/3919/comments"},"review_comments":{"href":"https://api.github.com/repos/livecode/livecode/pulls/3919/comments"},"review_comment":{"href":"https://api.github.com/repos/livecode/livecode/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/livecode/livecode/pulls/3919/commits"},"statuses":{"href":"https://api.github.com/repos/livecode/livecode/statuses/70b00e2fc06b2de5891b391fb4ffea8b64caff14"}}}}