{"action":"created","comment":{"url":"https://api.github.com/repos/ipfs/api/pulls/comments/47805033","id":47805033,"diff_hunk":"@@ -244,41 +305,301 @@ Lists all available commands (and subcommands) that are available.\n \n # Group config\n \n+## config [GET /config{?arg1,arg2}{&bool,json}]\n+\n+ipfs config controls configuration variables. It works\n+much like 'git config'. The configuration values are stored in a config\n+file inside your IPFS repository.\n+\n+**Examples:**\n+\n+Get the value of the 'datastore.path' key:\n+\n+    `ipfs config datastore.path`\n+\n+Set the value of the 'datastore.path' key:\n+\n+    `ipfs config datastore.path ~/.ipfs/datastore`\n+\n++ Parameters\n+    + arg1: \"Addresses.API\" (string, required) - The key of the config entry\n+    + arg2 (string, required) - The value to set the config entry to\n+    + bool (boolean, optional) - Set a boolean\n+    + json (boolean, optional) - Parse stringified JSON\n+\n++ Response 200 (application/json)\n+\n+    + Attributes (object)\n+        + `Key`: \"API.HTTPHeaders\" (string)\n+        + `Value`: null (string, nullable)\n+\n++ Response 500 (application/json)\n+\n+    + Attributes (object)\n+        + `Message` (string)\n+        + `Code`: 0 (number)\n+\n ## edit [GET /config/edit]\n+Opens the config file for editing in $EDITOR\n \n-+ Response 200 (text/plain)\n+To use 'ipfs config edit', you must have the $EDITOR environment\n+    variable set to your preferred text editor.\n \n-## replace [GET /config/replace]\n++ Response 200 (buffer)\n \n-+ Response 200 (text/plain)\n+## replace [GET /config/replace{?arg}]\n+Replaces the config with <file>\n+\n+Make sure to back up the config file first if neccessary, this operation\n+can't be undone.\n+\n++ Parameters\n+\n+    + arg (string, required) - The file to use as the new config\n+\n++ Response 200 ()\n \n ## show [GET /config/show]\n+Outputs the content of the config file\n+\n+**Warning**\n+\n+Your private key is stored in the config file, and it will be\n+included in the output of this command.\n \n + Response 200 (text/plain)\n \n+    + Attributes (object)\n+        + `API` (object)\n+            + `HTTPHeaders`: null (string, nullable)\n+        + `Addresses` (object)\n+            + `API`: \"/ip4/127.0.0.1/tcp/5001\" (string)\n+            + `Gateway`: \"/ip4/127.0.0.1/tcp/8080\" (string)\n+            + `Swarm` (array)\n+                - MultiAddr (string)\n+        + `Bootstrap` (array)\n+            - MultiAddr (string)\n+        + `Datastore` (object)\n+            - `GCPeriod`: \"\" (string)\n+            - `NoSync`: false (boolean)\n+            - `Params`: null (string, nullable)\n+            - `Path`: \"\" (string)\n+            - `StorageGCWatermark`: 90 (number)\n+            - `StorageMax`: \"10GB\" (string)\n+            - `Type`: \"\" (string)\n+        + `Discovery` (object)\n+            + `MDNS` (object)\n+                - `Enabled`: true (boolean)\n+                - `Interval`: 10 (number)\n+        + `Gateway` (object)\n+            - `HTTPHeaders`: null (string, nullable)\n+            - `RootRedirect`: \"\" (string)\n+            - `Writable`: false (boolean)\n+        + `Identity` (object)\n+            - `PeerID`: hash (string)\n+            - `PrivKey`: hash (string)\n+        + `Ipns` (object)\n+            - `RecordLifetime`: \"\" (string)\n+            - `RepublishPeriod`: \"\" (string)\n+            - `ResolveCacheSize`: 128 (number)\n+        + `Log` (object)\n+            - `MaxAgeDays`: 0 (number)\n+            - `MaxBackups`: 1 (number)\n+            - `MaxSizeMB`: 250 (number)\n+        + `Mounts` (object)\n+            - `FuseAllowOther`: false (boolean)\n+            - `IPFS`: \"/ipfs\" (string)\n+            - `IPFS`: \"/ipns\" (string)\n+        + `SupernodeRouting` (object)\n+            + `Servers` (array)\n+                - MultiAddr (string)\n+        + `Swarm` (object)\n+            - `AddrFilters`: null (string, nullable)\n+        + `Tour` (object)\n+            - `Last`: \"\" (string)\n+\n # Group daemon\n+Run a network-connected IPFS node\n+\n+`ipfs daemon` runs a persistent IPFS daemon that can serve commands\n+over the network. Most applications that use IPFS will do so by\n+communicating with a daemon over the HTTP API. While the daemon is\n+running, calls to `ipfs` commands will be sent over the network to\n+the daemon.\n+\n+The daemon will start listening on ports on the network, which are\n+documented in (and can be modified through) `ipfs config Addresses`.\n+For example, to change the `Gateway` port:\n+\n+    ipfs config Addresses.Gateway /ip4/127.0.0.1/tcp/8082","path":"apiary.apib","position":268,"original_position":268,"commit_id":"291bcb781cab7881bff7e40d9cc1c633e20a9504","original_commit_id":"291bcb781cab7881bff7e40d9cc1c633e20a9504","user":{"login":"Dignifiedquire","id":790842,"avatar_url":"https://avatars.githubusercontent.com/u/790842?v=3","gravatar_id":"","url":"https://api.github.com/users/Dignifiedquire","html_url":"https://github.com/Dignifiedquire","followers_url":"https://api.github.com/users/Dignifiedquire/followers","following_url":"https://api.github.com/users/Dignifiedquire/following{/other_user}","gists_url":"https://api.github.com/users/Dignifiedquire/gists{/gist_id}","starred_url":"https://api.github.com/users/Dignifiedquire/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Dignifiedquire/subscriptions","organizations_url":"https://api.github.com/users/Dignifiedquire/orgs","repos_url":"https://api.github.com/users/Dignifiedquire/repos","events_url":"https://api.github.com/users/Dignifiedquire/events{/privacy}","received_events_url":"https://api.github.com/users/Dignifiedquire/received_events","type":"User","site_admin":false},"body":"Again please no cli examples in here","created_at":"2015-12-16T17:16:45Z","updated_at":"2015-12-16T17:16:45Z","html_url":"https://github.com/ipfs/api/pull/13#discussion_r47805033","pull_request_url":"https://api.github.com/repos/ipfs/api/pulls/13","_links":{"self":{"href":"https://api.github.com/repos/ipfs/api/pulls/comments/47805033"},"html":{"href":"https://github.com/ipfs/api/pull/13#discussion_r47805033"},"pull_request":{"href":"https://api.github.com/repos/ipfs/api/pulls/13"}}},"pull_request":{"url":"https://api.github.com/repos/ipfs/api/pulls/13","id":53579344,"html_url":"https://github.com/ipfs/api/pull/13","diff_url":"https://github.com/ipfs/api/pull/13.diff","patch_url":"https://github.com/ipfs/api/pull/13.patch","issue_url":"https://api.github.com/repos/ipfs/api/issues/13","number":13,"state":"open","locked":false,"title":"Added more documentation","user":{"login":"RichardLitt","id":910753,"avatar_url":"https://avatars.githubusercontent.com/u/910753?v=3","gravatar_id":"","url":"https://api.github.com/users/RichardLitt","html_url":"https://github.com/RichardLitt","followers_url":"https://api.github.com/users/RichardLitt/followers","following_url":"https://api.github.com/users/RichardLitt/following{/other_user}","gists_url":"https://api.github.com/users/RichardLitt/gists{/gist_id}","starred_url":"https://api.github.com/users/RichardLitt/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/RichardLitt/subscriptions","organizations_url":"https://api.github.com/users/RichardLitt/orgs","repos_url":"https://api.github.com/users/RichardLitt/repos","events_url":"https://api.github.com/users/RichardLitt/events{/privacy}","received_events_url":"https://api.github.com/users/RichardLitt/received_events","type":"User","site_admin":false},"body":"So far: \r\n- [x] add","created_at":"2015-12-14T15:31:53Z","updated_at":"2015-12-16T17:16:45Z","closed_at":null,"merged_at":null,"merge_commit_sha":"468bf7da6855344b210afd21aac0543ff62df92e","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/ipfs/api/pulls/13/commits","review_comments_url":"https://api.github.com/repos/ipfs/api/pulls/13/comments","review_comment_url":"https://api.github.com/repos/ipfs/api/pulls/comments{/number}","comments_url":"https://api.github.com/repos/ipfs/api/issues/13/comments","statuses_url":"https://api.github.com/repos/ipfs/api/statuses/291bcb781cab7881bff7e40d9cc1c633e20a9504","head":{"label":"ipfs:feature/add","ref":"feature/add","sha":"291bcb781cab7881bff7e40d9cc1c633e20a9504","user":{"login":"ipfs","id":10536621,"avatar_url":"https://avatars.githubusercontent.com/u/10536621?v=3","gravatar_id":"","url":"https://api.github.com/users/ipfs","html_url":"https://github.com/ipfs","followers_url":"https://api.github.com/users/ipfs/followers","following_url":"https://api.github.com/users/ipfs/following{/other_user}","gists_url":"https://api.github.com/users/ipfs/gists{/gist_id}","starred_url":"https://api.github.com/users/ipfs/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ipfs/subscriptions","organizations_url":"https://api.github.com/users/ipfs/orgs","repos_url":"https://api.github.com/users/ipfs/repos","events_url":"https://api.github.com/users/ipfs/events{/privacy}","received_events_url":"https://api.github.com/users/ipfs/received_events","type":"Organization","site_admin":false},"repo":{"id":34368207,"name":"api","full_name":"ipfs/api","owner":{"login":"ipfs","id":10536621,"avatar_url":"https://avatars.githubusercontent.com/u/10536621?v=3","gravatar_id":"","url":"https://api.github.com/users/ipfs","html_url":"https://github.com/ipfs","followers_url":"https://api.github.com/users/ipfs/followers","following_url":"https://api.github.com/users/ipfs/following{/other_user}","gists_url":"https://api.github.com/users/ipfs/gists{/gist_id}","starred_url":"https://api.github.com/users/ipfs/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ipfs/subscriptions","organizations_url":"https://api.github.com/users/ipfs/orgs","repos_url":"https://api.github.com/users/ipfs/repos","events_url":"https://api.github.com/users/ipfs/events{/privacy}","received_events_url":"https://api.github.com/users/ipfs/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/ipfs/api","description":"The APIs ipfs implementations must conform to.","fork":false,"url":"https://api.github.com/repos/ipfs/api","forks_url":"https://api.github.com/repos/ipfs/api/forks","keys_url":"https://api.github.com/repos/ipfs/api/keys{/key_id}","collaborators_url":"https://api.github.com/repos/ipfs/api/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/ipfs/api/teams","hooks_url":"https://api.github.com/repos/ipfs/api/hooks","issue_events_url":"https://api.github.com/repos/ipfs/api/issues/events{/number}","events_url":"https://api.github.com/repos/ipfs/api/events","assignees_url":"https://api.github.com/repos/ipfs/api/assignees{/user}","branches_url":"https://api.github.com/repos/ipfs/api/branches{/branch}","tags_url":"https://api.github.com/repos/ipfs/api/tags","blobs_url":"https://api.github.com/repos/ipfs/api/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/ipfs/api/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/ipfs/api/git/refs{/sha}","trees_url":"https://api.github.com/repos/ipfs/api/git/trees{/sha}","statuses_url":"https://api.github.com/repos/ipfs/api/statuses/{sha}","languages_url":"https://api.github.com/repos/ipfs/api/languages","stargazers_url":"https://api.github.com/repos/ipfs/api/stargazers","contributors_url":"https://api.github.com/repos/ipfs/api/contributors","subscribers_url":"https://api.github.com/repos/ipfs/api/subscribers","subscription_url":"https://api.github.com/repos/ipfs/api/subscription","commits_url":"https://api.github.com/repos/ipfs/api/commits{/sha}","git_commits_url":"https://api.github.com/repos/ipfs/api/git/commits{/sha}","comments_url":"https://api.github.com/repos/ipfs/api/comments{/number}","issue_comment_url":"https://api.github.com/repos/ipfs/api/issues/comments{/number}","contents_url":"https://api.github.com/repos/ipfs/api/contents/{+path}","compare_url":"https://api.github.com/repos/ipfs/api/compare/{base}...{head}","merges_url":"https://api.github.com/repos/ipfs/api/merges","archive_url":"https://api.github.com/repos/ipfs/api/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/ipfs/api/downloads","issues_url":"https://api.github.com/repos/ipfs/api/issues{/number}","pulls_url":"https://api.github.com/repos/ipfs/api/pulls{/number}","milestones_url":"https://api.github.com/repos/ipfs/api/milestones{/number}","notifications_url":"https://api.github.com/repos/ipfs/api/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/ipfs/api/labels{/name}","releases_url":"https://api.github.com/repos/ipfs/api/releases{/id}","created_at":"2015-04-22T04:17:56Z","updated_at":"2015-12-12T17:47:05Z","pushed_at":"2015-12-16T16:51:58Z","git_url":"git://github.com/ipfs/api.git","ssh_url":"git@github.com:ipfs/api.git","clone_url":"https://github.com/ipfs/api.git","svn_url":"https://github.com/ipfs/api","homepage":null,"size":44,"stargazers_count":9,"watchers_count":9,"language":"API Blueprint","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":3,"mirror_url":null,"open_issues_count":8,"forks":3,"open_issues":8,"watchers":9,"default_branch":"master"}},"base":{"label":"ipfs:master","ref":"master","sha":"0acc5e13117aae66d3a3e82057e8d06b61360d0e","user":{"login":"ipfs","id":10536621,"avatar_url":"https://avatars.githubusercontent.com/u/10536621?v=3","gravatar_id":"","url":"https://api.github.com/users/ipfs","html_url":"https://github.com/ipfs","followers_url":"https://api.github.com/users/ipfs/followers","following_url":"https://api.github.com/users/ipfs/following{/other_user}","gists_url":"https://api.github.com/users/ipfs/gists{/gist_id}","starred_url":"https://api.github.com/users/ipfs/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ipfs/subscriptions","organizations_url":"https://api.github.com/users/ipfs/orgs","repos_url":"https://api.github.com/users/ipfs/repos","events_url":"https://api.github.com/users/ipfs/events{/privacy}","received_events_url":"https://api.github.com/users/ipfs/received_events","type":"Organization","site_admin":false},"repo":{"id":34368207,"name":"api","full_name":"ipfs/api","owner":{"login":"ipfs","id":10536621,"avatar_url":"https://avatars.githubusercontent.com/u/10536621?v=3","gravatar_id":"","url":"https://api.github.com/users/ipfs","html_url":"https://github.com/ipfs","followers_url":"https://api.github.com/users/ipfs/followers","following_url":"https://api.github.com/users/ipfs/following{/other_user}","gists_url":"https://api.github.com/users/ipfs/gists{/gist_id}","starred_url":"https://api.github.com/users/ipfs/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ipfs/subscriptions","organizations_url":"https://api.github.com/users/ipfs/orgs","repos_url":"https://api.github.com/users/ipfs/repos","events_url":"https://api.github.com/users/ipfs/events{/privacy}","received_events_url":"https://api.github.com/users/ipfs/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/ipfs/api","description":"The APIs ipfs implementations must conform to.","fork":false,"url":"https://api.github.com/repos/ipfs/api","forks_url":"https://api.github.com/repos/ipfs/api/forks","keys_url":"https://api.github.com/repos/ipfs/api/keys{/key_id}","collaborators_url":"https://api.github.com/repos/ipfs/api/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/ipfs/api/teams","hooks_url":"https://api.github.com/repos/ipfs/api/hooks","issue_events_url":"https://api.github.com/repos/ipfs/api/issues/events{/number}","events_url":"https://api.github.com/repos/ipfs/api/events","assignees_url":"https://api.github.com/repos/ipfs/api/assignees{/user}","branches_url":"https://api.github.com/repos/ipfs/api/branches{/branch}","tags_url":"https://api.github.com/repos/ipfs/api/tags","blobs_url":"https://api.github.com/repos/ipfs/api/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/ipfs/api/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/ipfs/api/git/refs{/sha}","trees_url":"https://api.github.com/repos/ipfs/api/git/trees{/sha}","statuses_url":"https://api.github.com/repos/ipfs/api/statuses/{sha}","languages_url":"https://api.github.com/repos/ipfs/api/languages","stargazers_url":"https://api.github.com/repos/ipfs/api/stargazers","contributors_url":"https://api.github.com/repos/ipfs/api/contributors","subscribers_url":"https://api.github.com/repos/ipfs/api/subscribers","subscription_url":"https://api.github.com/repos/ipfs/api/subscription","commits_url":"https://api.github.com/repos/ipfs/api/commits{/sha}","git_commits_url":"https://api.github.com/repos/ipfs/api/git/commits{/sha}","comments_url":"https://api.github.com/repos/ipfs/api/comments{/number}","issue_comment_url":"https://api.github.com/repos/ipfs/api/issues/comments{/number}","contents_url":"https://api.github.com/repos/ipfs/api/contents/{+path}","compare_url":"https://api.github.com/repos/ipfs/api/compare/{base}...{head}","merges_url":"https://api.github.com/repos/ipfs/api/merges","archive_url":"https://api.github.com/repos/ipfs/api/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/ipfs/api/downloads","issues_url":"https://api.github.com/repos/ipfs/api/issues{/number}","pulls_url":"https://api.github.com/repos/ipfs/api/pulls{/number}","milestones_url":"https://api.github.com/repos/ipfs/api/milestones{/number}","notifications_url":"https://api.github.com/repos/ipfs/api/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/ipfs/api/labels{/name}","releases_url":"https://api.github.com/repos/ipfs/api/releases{/id}","created_at":"2015-04-22T04:17:56Z","updated_at":"2015-12-12T17:47:05Z","pushed_at":"2015-12-16T16:51:58Z","git_url":"git://github.com/ipfs/api.git","ssh_url":"git@github.com:ipfs/api.git","clone_url":"https://github.com/ipfs/api.git","svn_url":"https://github.com/ipfs/api","homepage":null,"size":44,"stargazers_count":9,"watchers_count":9,"language":"API Blueprint","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":3,"mirror_url":null,"open_issues_count":8,"forks":3,"open_issues":8,"watchers":9,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/ipfs/api/pulls/13"},"html":{"href":"https://github.com/ipfs/api/pull/13"},"issue":{"href":"https://api.github.com/repos/ipfs/api/issues/13"},"comments":{"href":"https://api.github.com/repos/ipfs/api/issues/13/comments"},"review_comments":{"href":"https://api.github.com/repos/ipfs/api/pulls/13/comments"},"review_comment":{"href":"https://api.github.com/repos/ipfs/api/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/ipfs/api/pulls/13/commits"},"statuses":{"href":"https://api.github.com/repos/ipfs/api/statuses/291bcb781cab7881bff7e40d9cc1c633e20a9504"}}}}