{"action":"created","comment":{"url":"https://api.github.com/repos/chapel-lang/chapel/pulls/comments/39907112","id":39907112,"diff_hunk":"@@ -0,0 +1,369 @@\n+=========================\n+Executing Chapel Programs\n+=========================\n+\n+Once you have compiled a Chapel program using the chpl compiler, you\n+can execute it from the command-line like any other program.  This\n+document discusses command line options, environment variables, and\n+other topics having to do with running programs written in Chapel.\n+\n+.. contents::\n+\n+\n+------------\n+Getting Help\n+------------\n+\n+Using the -h or --help flags will print out help for the executable.\n+For example:\n+\n+  .. code-block:: sh\n+\n+    ./a.out --help\n+\n+This flag lists all of the standard flags that can be used with a\n+Chapel program, as well as a list of the configuration variables\n+defined by the program and their types.  If the configuration variable\n+has been set on the command line, its value is also shown.\n+\n+\n+-------------------------------\n+Setting Configuration Variables\n+-------------------------------\n+\n+Configuration constants and variables defined in a Chapel program can\n+have their default values overridden on the command line using the ``-s``\n+or ``--`` flags.  Either flag takes the name of the configuration variable\n+followed by an equals character (``=``)' and the value to assign to it.\n+This value must be a legal Chapel literal for the type of the variable.\n+(Exception: for a string literal, the surrounding quotes are implicit.)\n+In our current implementation, no extra spaces may appear between\n+these elements.  Thus, the general form is:\n+\n+  .. code-block:: sh\n+\n+    ./a.out --<cfgVar>=<val>\n+\n+or:\n+\n+  .. code-block:: sh\n+\n+    ./a.out -s<cfgVar>=<val>\n+\n+As an example, compile the hello2-module.chpl example which prints a\n+user-definable message:\n+\n+  .. code-block:: sh\n+\n+    chpl -o hello2-module $CHPL_HOME/examples/hello2-module.chpl\n+\n+This program defines a configuration constant, ``message``, indicating\n+the string to print to the console, set to ``\"Hello, world!\"`` by\n+default.  To override the default, you can use:\n+\n+  .. code-block:: sh\n+\n+    ./hello2-module --message='Hello, Chapel users!'\n+\n+or:\n+\n+  .. code-block:: sh\n+\n+    ./hello2-module -smessage='Hello, Chapel users!'\n+\n+The default value of a configuration constant or variable can also be\n+overridden at compilation time with a ``-s`` option. (The surrounding\n+quotes must be provided for a string literal.) For example:\n+\n+  .. code-block:: sh\n+\n+    cd $CHPL_HOME/examples\n+    chpl -smessage='\"Hello from the Chapel compiler\"' hello2-module.chpl\n+\n+or:\n+\n+  .. code-block:: sh\n+\n+    chpl -s message=\"'Hello from the Chapel compiler'\" hello2-module.chpl\n+\n+The compiler-established default can still be overridden when\n+executing the program, as shown above.\n+\n+Chapel programs can also accept C-like command line arguments to their\n+``main()`` procedure in addition to the aforementioned configuration\n+variables. See :doc:`technotes/main` for more information.\n+\n+\n+-----------------------------\n+Setting the Number of Locales\n+-----------------------------\n+\n+For multi-locale Chapel executions, the number of locales on which to\n+execute a program is specified on the executable's command-line.  This\n+can be set either using the -nl flag, or by assigning to the built-in\n+numLocales configuration constant using the normal mechanisms.  So, to\n+execute on four locales, one could use:\n+\n+  .. code-block:: sh\n+\n+    ./a.out -nl 4\n+\n+or:\n+\n+  .. code-block:: sh\n+\n+    ./a.out --numLocales=4\n+\n+or:\n+\n+  .. code-block:: sh\n+\n+    ./a.out -snumLocales=4\n+\n+For users running with ``$CHPL_COMM=none`` (the default), only one\n+locale can be used.  See :doc:`multilocale` for more","path":"doc/release/README.executing.rst","position":124,"original_position":124,"commit_id":"98df6ece72bd8f27c9da0a188e5952210824585e","original_commit_id":"98df6ece72bd8f27c9da0a188e5952210824585e","user":{"login":"ben-albrecht","id":3595449,"avatar_url":"https://avatars.githubusercontent.com/u/3595449?v=3","gravatar_id":"","url":"https://api.github.com/users/ben-albrecht","html_url":"https://github.com/ben-albrecht","followers_url":"https://api.github.com/users/ben-albrecht/followers","following_url":"https://api.github.com/users/ben-albrecht/following{/other_user}","gists_url":"https://api.github.com/users/ben-albrecht/gists{/gist_id}","starred_url":"https://api.github.com/users/ben-albrecht/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ben-albrecht/subscriptions","organizations_url":"https://api.github.com/users/ben-albrecht/orgs","repos_url":"https://api.github.com/users/ben-albrecht/repos","events_url":"https://api.github.com/users/ben-albrecht/events{/privacy}","received_events_url":"https://api.github.com/users/ben-albrecht/received_events","type":"User","site_admin":false},"body":"We are going to leave cross-references out until all READMEs are converted. This file won't actually exist in the sphinx project until it has been converted to reST.","created_at":"2015-09-18T22:24:02Z","updated_at":"2015-09-18T22:24:02Z","html_url":"https://github.com/chapel-lang/chapel/pull/2568#discussion_r39907112","pull_request_url":"https://api.github.com/repos/chapel-lang/chapel/pulls/2568","_links":{"self":{"href":"https://api.github.com/repos/chapel-lang/chapel/pulls/comments/39907112"},"html":{"href":"https://github.com/chapel-lang/chapel/pull/2568#discussion_r39907112"},"pull_request":{"href":"https://api.github.com/repos/chapel-lang/chapel/pulls/2568"}}},"pull_request":{"url":"https://api.github.com/repos/chapel-lang/chapel/pulls/2568","id":45454625,"html_url":"https://github.com/chapel-lang/chapel/pull/2568","diff_url":"https://github.com/chapel-lang/chapel/pull/2568.diff","patch_url":"https://github.com/chapel-lang/chapel/pull/2568.patch","issue_url":"https://api.github.com/repos/chapel-lang/chapel/issues/2568","number":2568,"state":"open","locked":false,"title":"Rstify executing","user":{"login":"gbtitus","id":7740880,"avatar_url":"https://avatars.githubusercontent.com/u/7740880?v=3","gravatar_id":"","url":"https://api.github.com/users/gbtitus","html_url":"https://github.com/gbtitus","followers_url":"https://api.github.com/users/gbtitus/followers","following_url":"https://api.github.com/users/gbtitus/following{/other_user}","gists_url":"https://api.github.com/users/gbtitus/gists{/gist_id}","starred_url":"https://api.github.com/users/gbtitus/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/gbtitus/subscriptions","organizations_url":"https://api.github.com/users/gbtitus/orgs","repos_url":"https://api.github.com/users/gbtitus/repos","events_url":"https://api.github.com/users/gbtitus/events{/privacy}","received_events_url":"https://api.github.com/users/gbtitus/received_events","type":"User","site_admin":false},"body":"Rename README.executing and convert it to ReStructuredText.","created_at":"2015-09-18T21:26:34Z","updated_at":"2015-09-18T22:24:02Z","closed_at":null,"merged_at":null,"merge_commit_sha":"4a6f46af077062e5df0d82be77c2a74745e39db2","assignee":{"login":"vasslitvinov","id":8039635,"avatar_url":"https://avatars.githubusercontent.com/u/8039635?v=3","gravatar_id":"","url":"https://api.github.com/users/vasslitvinov","html_url":"https://github.com/vasslitvinov","followers_url":"https://api.github.com/users/vasslitvinov/followers","following_url":"https://api.github.com/users/vasslitvinov/following{/other_user}","gists_url":"https://api.github.com/users/vasslitvinov/gists{/gist_id}","starred_url":"https://api.github.com/users/vasslitvinov/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/vasslitvinov/subscriptions","organizations_url":"https://api.github.com/users/vasslitvinov/orgs","repos_url":"https://api.github.com/users/vasslitvinov/repos","events_url":"https://api.github.com/users/vasslitvinov/events{/privacy}","received_events_url":"https://api.github.com/users/vasslitvinov/received_events","type":"User","site_admin":false},"milestone":null,"commits_url":"https://api.github.com/repos/chapel-lang/chapel/pulls/2568/commits","review_comments_url":"https://api.github.com/repos/chapel-lang/chapel/pulls/2568/comments","review_comment_url":"https://api.github.com/repos/chapel-lang/chapel/pulls/comments{/number}","comments_url":"https://api.github.com/repos/chapel-lang/chapel/issues/2568/comments","statuses_url":"https://api.github.com/repos/chapel-lang/chapel/statuses/98df6ece72bd8f27c9da0a188e5952210824585e","head":{"label":"gbtitus:rstify-executing","ref":"rstify-executing","sha":"98df6ece72bd8f27c9da0a188e5952210824585e","user":{"login":"gbtitus","id":7740880,"avatar_url":"https://avatars.githubusercontent.com/u/7740880?v=3","gravatar_id":"","url":"https://api.github.com/users/gbtitus","html_url":"https://github.com/gbtitus","followers_url":"https://api.github.com/users/gbtitus/followers","following_url":"https://api.github.com/users/gbtitus/following{/other_user}","gists_url":"https://api.github.com/users/gbtitus/gists{/gist_id}","starred_url":"https://api.github.com/users/gbtitus/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/gbtitus/subscriptions","organizations_url":"https://api.github.com/users/gbtitus/orgs","repos_url":"https://api.github.com/users/gbtitus/repos","events_url":"https://api.github.com/users/gbtitus/events{/privacy}","received_events_url":"https://api.github.com/users/gbtitus/received_events","type":"User","site_admin":false},"repo":{"id":21912579,"name":"chapel","full_name":"gbtitus/chapel","owner":{"login":"gbtitus","id":7740880,"avatar_url":"https://avatars.githubusercontent.com/u/7740880?v=3","gravatar_id":"","url":"https://api.github.com/users/gbtitus","html_url":"https://github.com/gbtitus","followers_url":"https://api.github.com/users/gbtitus/followers","following_url":"https://api.github.com/users/gbtitus/following{/other_user}","gists_url":"https://api.github.com/users/gbtitus/gists{/gist_id}","starred_url":"https://api.github.com/users/gbtitus/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/gbtitus/subscriptions","organizations_url":"https://api.github.com/users/gbtitus/orgs","repos_url":"https://api.github.com/users/gbtitus/repos","events_url":"https://api.github.com/users/gbtitus/events{/privacy}","received_events_url":"https://api.github.com/users/gbtitus/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/gbtitus/chapel","description":"a Productive Parallel Programming Language","fork":true,"url":"https://api.github.com/repos/gbtitus/chapel","forks_url":"https://api.github.com/repos/gbtitus/chapel/forks","keys_url":"https://api.github.com/repos/gbtitus/chapel/keys{/key_id}","collaborators_url":"https://api.github.com/repos/gbtitus/chapel/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/gbtitus/chapel/teams","hooks_url":"https://api.github.com/repos/gbtitus/chapel/hooks","issue_events_url":"https://api.github.com/repos/gbtitus/chapel/issues/events{/number}","events_url":"https://api.github.com/repos/gbtitus/chapel/events","assignees_url":"https://api.github.com/repos/gbtitus/chapel/assignees{/user}","branches_url":"https://api.github.com/repos/gbtitus/chapel/branches{/branch}","tags_url":"https://api.github.com/repos/gbtitus/chapel/tags","blobs_url":"https://api.github.com/repos/gbtitus/chapel/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/gbtitus/chapel/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/gbtitus/chapel/git/refs{/sha}","trees_url":"https://api.github.com/repos/gbtitus/chapel/git/trees{/sha}","statuses_url":"https://api.github.com/repos/gbtitus/chapel/statuses/{sha}","languages_url":"https://api.github.com/repos/gbtitus/chapel/languages","stargazers_url":"https://api.github.com/repos/gbtitus/chapel/stargazers","contributors_url":"https://api.github.com/repos/gbtitus/chapel/contributors","subscribers_url":"https://api.github.com/repos/gbtitus/chapel/subscribers","subscription_url":"https://api.github.com/repos/gbtitus/chapel/subscription","commits_url":"https://api.github.com/repos/gbtitus/chapel/commits{/sha}","git_commits_url":"https://api.github.com/repos/gbtitus/chapel/git/commits{/sha}","comments_url":"https://api.github.com/repos/gbtitus/chapel/comments{/number}","issue_comment_url":"https://api.github.com/repos/gbtitus/chapel/issues/comments{/number}","contents_url":"https://api.github.com/repos/gbtitus/chapel/contents/{+path}","compare_url":"https://api.github.com/repos/gbtitus/chapel/compare/{base}...{head}","merges_url":"https://api.github.com/repos/gbtitus/chapel/merges","archive_url":"https://api.github.com/repos/gbtitus/chapel/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/gbtitus/chapel/downloads","issues_url":"https://api.github.com/repos/gbtitus/chapel/issues{/number}","pulls_url":"https://api.github.com/repos/gbtitus/chapel/pulls{/number}","milestones_url":"https://api.github.com/repos/gbtitus/chapel/milestones{/number}","notifications_url":"https://api.github.com/repos/gbtitus/chapel/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/gbtitus/chapel/labels{/name}","releases_url":"https://api.github.com/repos/gbtitus/chapel/releases{/id}","created_at":"2014-07-16T18:39:09Z","updated_at":"2015-05-08T19:16:43Z","pushed_at":"2015-09-18T20:54:24Z","git_url":"git://github.com/gbtitus/chapel.git","ssh_url":"git@github.com:gbtitus/chapel.git","clone_url":"https://github.com/gbtitus/chapel.git","svn_url":"https://github.com/gbtitus/chapel","homepage":"http://chapel.cray.com/","size":314923,"stargazers_count":2,"watchers_count":2,"language":"Chapel","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":2,"default_branch":"master"}},"base":{"label":"chapel-lang:master","ref":"master","sha":"e32ec9767ba265b8d9de35a1b6705f9599e403c9","user":{"login":"chapel-lang","id":7597261,"avatar_url":"https://avatars.githubusercontent.com/u/7597261?v=3","gravatar_id":"","url":"https://api.github.com/users/chapel-lang","html_url":"https://github.com/chapel-lang","followers_url":"https://api.github.com/users/chapel-lang/followers","following_url":"https://api.github.com/users/chapel-lang/following{/other_user}","gists_url":"https://api.github.com/users/chapel-lang/gists{/gist_id}","starred_url":"https://api.github.com/users/chapel-lang/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/chapel-lang/subscriptions","organizations_url":"https://api.github.com/users/chapel-lang/orgs","repos_url":"https://api.github.com/users/chapel-lang/repos","events_url":"https://api.github.com/users/chapel-lang/events{/privacy}","received_events_url":"https://api.github.com/users/chapel-lang/received_events","type":"Organization","site_admin":false},"repo":{"id":21663285,"name":"chapel","full_name":"chapel-lang/chapel","owner":{"login":"chapel-lang","id":7597261,"avatar_url":"https://avatars.githubusercontent.com/u/7597261?v=3","gravatar_id":"","url":"https://api.github.com/users/chapel-lang","html_url":"https://github.com/chapel-lang","followers_url":"https://api.github.com/users/chapel-lang/followers","following_url":"https://api.github.com/users/chapel-lang/following{/other_user}","gists_url":"https://api.github.com/users/chapel-lang/gists{/gist_id}","starred_url":"https://api.github.com/users/chapel-lang/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/chapel-lang/subscriptions","organizations_url":"https://api.github.com/users/chapel-lang/orgs","repos_url":"https://api.github.com/users/chapel-lang/repos","events_url":"https://api.github.com/users/chapel-lang/events{/privacy}","received_events_url":"https://api.github.com/users/chapel-lang/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/chapel-lang/chapel","description":"a Productive Parallel Programming Language","fork":false,"url":"https://api.github.com/repos/chapel-lang/chapel","forks_url":"https://api.github.com/repos/chapel-lang/chapel/forks","keys_url":"https://api.github.com/repos/chapel-lang/chapel/keys{/key_id}","collaborators_url":"https://api.github.com/repos/chapel-lang/chapel/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/chapel-lang/chapel/teams","hooks_url":"https://api.github.com/repos/chapel-lang/chapel/hooks","issue_events_url":"https://api.github.com/repos/chapel-lang/chapel/issues/events{/number}","events_url":"https://api.github.com/repos/chapel-lang/chapel/events","assignees_url":"https://api.github.com/repos/chapel-lang/chapel/assignees{/user}","branches_url":"https://api.github.com/repos/chapel-lang/chapel/branches{/branch}","tags_url":"https://api.github.com/repos/chapel-lang/chapel/tags","blobs_url":"https://api.github.com/repos/chapel-lang/chapel/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/chapel-lang/chapel/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/chapel-lang/chapel/git/refs{/sha}","trees_url":"https://api.github.com/repos/chapel-lang/chapel/git/trees{/sha}","statuses_url":"https://api.github.com/repos/chapel-lang/chapel/statuses/{sha}","languages_url":"https://api.github.com/repos/chapel-lang/chapel/languages","stargazers_url":"https://api.github.com/repos/chapel-lang/chapel/stargazers","contributors_url":"https://api.github.com/repos/chapel-lang/chapel/contributors","subscribers_url":"https://api.github.com/repos/chapel-lang/chapel/subscribers","subscription_url":"https://api.github.com/repos/chapel-lang/chapel/subscription","commits_url":"https://api.github.com/repos/chapel-lang/chapel/commits{/sha}","git_commits_url":"https://api.github.com/repos/chapel-lang/chapel/git/commits{/sha}","comments_url":"https://api.github.com/repos/chapel-lang/chapel/comments{/number}","issue_comment_url":"https://api.github.com/repos/chapel-lang/chapel/issues/comments{/number}","contents_url":"https://api.github.com/repos/chapel-lang/chapel/contents/{+path}","compare_url":"https://api.github.com/repos/chapel-lang/chapel/compare/{base}...{head}","merges_url":"https://api.github.com/repos/chapel-lang/chapel/merges","archive_url":"https://api.github.com/repos/chapel-lang/chapel/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/chapel-lang/chapel/downloads","issues_url":"https://api.github.com/repos/chapel-lang/chapel/issues{/number}","pulls_url":"https://api.github.com/repos/chapel-lang/chapel/pulls{/number}","milestones_url":"https://api.github.com/repos/chapel-lang/chapel/milestones{/number}","notifications_url":"https://api.github.com/repos/chapel-lang/chapel/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/chapel-lang/chapel/labels{/name}","releases_url":"https://api.github.com/repos/chapel-lang/chapel/releases{/id}","created_at":"2014-07-09T18:15:54Z","updated_at":"2015-09-08T07:33:39Z","pushed_at":"2015-09-18T22:11:26Z","git_url":"git://github.com/chapel-lang/chapel.git","ssh_url":"git@github.com:chapel-lang/chapel.git","clone_url":"https://github.com/chapel-lang/chapel.git","svn_url":"https://github.com/chapel-lang/chapel","homepage":"http://chapel.cray.com/","size":486310,"stargazers_count":139,"watchers_count":139,"language":"Chapel","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":51,"mirror_url":null,"open_issues_count":20,"forks":51,"open_issues":20,"watchers":139,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/chapel-lang/chapel/pulls/2568"},"html":{"href":"https://github.com/chapel-lang/chapel/pull/2568"},"issue":{"href":"https://api.github.com/repos/chapel-lang/chapel/issues/2568"},"comments":{"href":"https://api.github.com/repos/chapel-lang/chapel/issues/2568/comments"},"review_comments":{"href":"https://api.github.com/repos/chapel-lang/chapel/pulls/2568/comments"},"review_comment":{"href":"https://api.github.com/repos/chapel-lang/chapel/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/chapel-lang/chapel/pulls/2568/commits"},"statuses":{"href":"https://api.github.com/repos/chapel-lang/chapel/statuses/98df6ece72bd8f27c9da0a188e5952210824585e"}}}}