{"action":"created","comment":{"url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/pulls/comments/76691016","id":76691016,"diff_hunk":"@@ -0,0 +1,84 @@\n+# Configuring launch.json for C/C++ Debugging\r\n+\r\n+the `launch.json` file is used to configure the debugger in Visual Studio Code \r\n+\r\n+Visual Studio Code generates a `launch.json` with almost all of the required information.  To get started\r\n+debugging you need to fill in the `program` field with the path to the executable you plan to debug. This must be specified for \r\n+both the launch and attach (if you plan to attach to a running instance at any point) configurations.\r\n+\r\n+The generated file contains two sections.  One that configures debugging for launch and a second that configures debugging for attach.\r\n+\r\n+# JSON Properties\r\n+\r\n+**program**: `Required` Specifies the full path to executable the debugger will launch or attach to. This property must be set\r\n+\r\n+**args**: JSON array of command line arguments passed to the program (e.g. [\"arg1\", \"arg2])\r\n+\r\n+**cwd**: Sets the the working directory of the application launched by the debugger\r\n+\r\n+**visualizerFile**: .natvis file to be used when debugging this process. See [Natvis syntax reference](http://aka.ms/natvis#Anchor_8) for information on how to create natvis files\r\n+\r\n+**environment**: Environment variables to add to the environment for the program. Example: `[ { \\\"name\\\": \\\"squid\\\", \\\"value\\\": \\\"clam\\\" } ]`\r\n+              \r\n+**filterStdout**: Search stdout stream for server-started pattern and log stdout to debug output. Defaults to true.\r\n+                \r\n+**filterStderr**: Search stderr stream for server-started pattern and log stderr to debug output. Defaults to false.\r\n+               \r\n+**externalConsole**: If true, a console is launched for the debuggee. If false, no console is launched. Note this option is ignored in some cases for technical reasons\r\n+\r\n+**logging**: Optional flags to determine what types of messages should be logged to the Debug Console\r\n+  * **exceptions**: Optional flag to determine whether exception messages should be logged to the Debug Console. Defaults to true\r\n+  * **moduleLoad**: Optional flag to determine whether module load events should be logged to the Debug Console. Defaults to true\r\n+  * **programOutput**: Optional flag to determine whether program output should be logged to the Debug Console. Defaults to true\r\n+  * **engineLogging**: Optional flag to determine whether diagnostic engine logs should be logged to the Debug Console. Defaults to false\r\n+  * **trace**: Optional flag to determine whether diagnostic adapter command tracing should be logged to the Debug Console. Defaults to false\r\n+  * **traceResponse**: Optional flag to determine whether diagnostic adapter command and response tracing should be logged to the Debug Console. Defaults to false\r\n+\r\n+## Visual Studio Windows Debugger Properties\r\n+\r\n+**symbolSearchPath**: Semicolon separated list of directories to use to search for symbol (.pdb) files\r\n+\r\n+**dumpPath**: Path to the dump file for the program to start debugging\r\n+\r\n+**type**: Indicates the underlying debugger being used. Must be \\\"cppvsdbg\\\" when using the Visual Studio Windows debugger\r\n+\r\n+### GDB or LLDB Properties \r\n+\r\n+**additionalSOLibSearchPath**: Semicolon separated list of directories to use to search for .so files. Example: `\\\"/Users/user/dir1;/Users/user/dir2\\\"`\r\n+\r\n+**MIMode**: Indicates the debugger that VS Code will connect to. Must be set to `gdb` or `lldb`.  This is configured on a per-operating system \r\n+basis.  Visual Studio code generates a section for `linux`, `osx`, `windows` automatically\r\n+\r\n+**miDebuggerPath**: The path to the debugger (such as gdb). When unspecified, it will search path first for the debugger. default\": \"/usr/bin/gdb\"\r\n+\r\n+**miDebuggerServerAddress**: Network address of the debugger server (e.g. gdbserver) to connect to (example: `localhost:1234`).\r\n+\r\n+**stopAtEntry**: If set to true, the debugger should stop at the entrypoint of the target (ignored on attach). Default value is `false`\r\n+\r\n+**debugServerPath**: Full path to debug server to launch\r\n+\r\n+**debugServerArgs**: Arguments for the the debugger server\r\n+                \r\n+**serverStarted**: Server-started pattern to look for in the debug server output\r\n+\r\n+**serverLaunchTimeout**: Time in milliseconds, for the debugger to wait for the debugServer to start up. Default is 10000\r\n+\r\n+**coreDumpPath**: OFull path to a core dump file to debug for the specified program\r","path":"Debugging/LaunchOptions.md","position":66,"original_position":66,"commit_id":"db0c60eb25063b757e1bb822c90efefcd2b85005","original_commit_id":"db0c60eb25063b757e1bb822c90efefcd2b85005","user":{"login":"Andrew-MSFT","id":12432803,"avatar_url":"https://avatars.githubusercontent.com/u/12432803?v=3","gravatar_id":"","url":"https://api.github.com/users/Andrew-MSFT","html_url":"https://github.com/Andrew-MSFT","followers_url":"https://api.github.com/users/Andrew-MSFT/followers","following_url":"https://api.github.com/users/Andrew-MSFT/following{/other_user}","gists_url":"https://api.github.com/users/Andrew-MSFT/gists{/gist_id}","starred_url":"https://api.github.com/users/Andrew-MSFT/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Andrew-MSFT/subscriptions","organizations_url":"https://api.github.com/users/Andrew-MSFT/orgs","repos_url":"https://api.github.com/users/Andrew-MSFT/repos","events_url":"https://api.github.com/users/Andrew-MSFT/events{/privacy}","received_events_url":"https://api.github.com/users/Andrew-MSFT/received_events","type":"User","site_admin":false},"body":"Nope, just a typo :-)","created_at":"2016-08-29T21:28:44Z","updated_at":"2016-08-29T21:28:44Z","html_url":"https://github.com/Microsoft/vscode-cpptools2/pull/3#discussion_r76691016","pull_request_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/pulls/3","_links":{"self":{"href":"https://api.github.com/repos/Microsoft/vscode-cpptools2/pulls/comments/76691016"},"html":{"href":"https://github.com/Microsoft/vscode-cpptools2/pull/3#discussion_r76691016"},"pull_request":{"href":"https://api.github.com/repos/Microsoft/vscode-cpptools2/pulls/3"}}},"pull_request":{"url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/pulls/3","id":83112479,"html_url":"https://github.com/Microsoft/vscode-cpptools2/pull/3","diff_url":"https://github.com/Microsoft/vscode-cpptools2/pull/3.diff","patch_url":"https://github.com/Microsoft/vscode-cpptools2/pull/3.patch","issue_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/issues/3","number":3,"state":"open","locked":false,"title":"Initial launch.json doc","user":{"login":"Andrew-MSFT","id":12432803,"avatar_url":"https://avatars.githubusercontent.com/u/12432803?v=3","gravatar_id":"","url":"https://api.github.com/users/Andrew-MSFT","html_url":"https://github.com/Andrew-MSFT","followers_url":"https://api.github.com/users/Andrew-MSFT/followers","following_url":"https://api.github.com/users/Andrew-MSFT/following{/other_user}","gists_url":"https://api.github.com/users/Andrew-MSFT/gists{/gist_id}","starred_url":"https://api.github.com/users/Andrew-MSFT/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Andrew-MSFT/subscriptions","organizations_url":"https://api.github.com/users/Andrew-MSFT/orgs","repos_url":"https://api.github.com/users/Andrew-MSFT/repos","events_url":"https://api.github.com/users/Andrew-MSFT/events{/privacy}","received_events_url":"https://api.github.com/users/Andrew-MSFT/received_events","type":"User","site_admin":false},"body":"@jacdavis @pieandcakes @delmyers this is a stab at an initial doc for the launch.json file, please review.  Doing it in this repository as a placeholder as I didn't want renaming the other repo to potentially mess up the PR. We'll move it to the real repo once it's ready.","created_at":"2016-08-29T14:55:04Z","updated_at":"2016-08-29T21:28:44Z","closed_at":null,"merged_at":null,"merge_commit_sha":"005f12a4e37d8cda90a6c88afb97e21935532a8b","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/pulls/3/commits","review_comments_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/pulls/3/comments","review_comment_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/pulls/comments{/number}","comments_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/issues/3/comments","statuses_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/statuses/db0c60eb25063b757e1bb822c90efefcd2b85005","head":{"label":"Microsoft:andrehal-docs","ref":"andrehal-docs","sha":"db0c60eb25063b757e1bb822c90efefcd2b85005","user":{"login":"Microsoft","id":6154722,"avatar_url":"https://avatars.githubusercontent.com/u/6154722?v=3","gravatar_id":"","url":"https://api.github.com/users/Microsoft","html_url":"https://github.com/Microsoft","followers_url":"https://api.github.com/users/Microsoft/followers","following_url":"https://api.github.com/users/Microsoft/following{/other_user}","gists_url":"https://api.github.com/users/Microsoft/gists{/gist_id}","starred_url":"https://api.github.com/users/Microsoft/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Microsoft/subscriptions","organizations_url":"https://api.github.com/users/Microsoft/orgs","repos_url":"https://api.github.com/users/Microsoft/repos","events_url":"https://api.github.com/users/Microsoft/events{/privacy}","received_events_url":"https://api.github.com/users/Microsoft/received_events","type":"Organization","site_admin":false},"repo":{"id":65399763,"name":"vscode-cpptools2","full_name":"Microsoft/vscode-cpptools2","owner":{"login":"Microsoft","id":6154722,"avatar_url":"https://avatars.githubusercontent.com/u/6154722?v=3","gravatar_id":"","url":"https://api.github.com/users/Microsoft","html_url":"https://github.com/Microsoft","followers_url":"https://api.github.com/users/Microsoft/followers","following_url":"https://api.github.com/users/Microsoft/following{/other_user}","gists_url":"https://api.github.com/users/Microsoft/gists{/gist_id}","starred_url":"https://api.github.com/users/Microsoft/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Microsoft/subscriptions","organizations_url":"https://api.github.com/users/Microsoft/orgs","repos_url":"https://api.github.com/users/Microsoft/repos","events_url":"https://api.github.com/users/Microsoft/events{/privacy}","received_events_url":"https://api.github.com/users/Microsoft/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/Microsoft/vscode-cpptools2","description":"Repo that holds documentation and tracks issues for the VS Code cpptools extension","fork":false,"url":"https://api.github.com/repos/Microsoft/vscode-cpptools2","forks_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/forks","keys_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/keys{/key_id}","collaborators_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/teams","hooks_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/hooks","issue_events_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/issues/events{/number}","events_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/events","assignees_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/assignees{/user}","branches_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/branches{/branch}","tags_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/tags","blobs_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/git/refs{/sha}","trees_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/git/trees{/sha}","statuses_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/statuses/{sha}","languages_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/languages","stargazers_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/stargazers","contributors_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/contributors","subscribers_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/subscribers","subscription_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/subscription","commits_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/commits{/sha}","git_commits_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/git/commits{/sha}","comments_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/comments{/number}","issue_comment_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/issues/comments{/number}","contents_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/contents/{+path}","compare_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/compare/{base}...{head}","merges_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/merges","archive_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/downloads","issues_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/issues{/number}","pulls_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/pulls{/number}","milestones_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/milestones{/number}","notifications_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/labels{/name}","releases_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/releases{/id}","deployments_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/deployments","created_at":"2016-08-10T16:46:54Z","updated_at":"2016-08-26T22:25:31Z","pushed_at":"2016-08-29T14:55:04Z","git_url":"git://github.com/Microsoft/vscode-cpptools2.git","ssh_url":"git@github.com:Microsoft/vscode-cpptools2.git","clone_url":"https://github.com/Microsoft/vscode-cpptools2.git","svn_url":"https://github.com/Microsoft/vscode-cpptools2","homepage":"https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools","size":5,"stargazers_count":0,"watchers_count":0,"language":null,"has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":2,"forks":0,"open_issues":2,"watchers":0,"default_branch":"master"}},"base":{"label":"Microsoft:master","ref":"master","sha":"e308e09a3f936ed8011b0bbbe7e372e1b6c063a1","user":{"login":"Microsoft","id":6154722,"avatar_url":"https://avatars.githubusercontent.com/u/6154722?v=3","gravatar_id":"","url":"https://api.github.com/users/Microsoft","html_url":"https://github.com/Microsoft","followers_url":"https://api.github.com/users/Microsoft/followers","following_url":"https://api.github.com/users/Microsoft/following{/other_user}","gists_url":"https://api.github.com/users/Microsoft/gists{/gist_id}","starred_url":"https://api.github.com/users/Microsoft/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Microsoft/subscriptions","organizations_url":"https://api.github.com/users/Microsoft/orgs","repos_url":"https://api.github.com/users/Microsoft/repos","events_url":"https://api.github.com/users/Microsoft/events{/privacy}","received_events_url":"https://api.github.com/users/Microsoft/received_events","type":"Organization","site_admin":false},"repo":{"id":65399763,"name":"vscode-cpptools2","full_name":"Microsoft/vscode-cpptools2","owner":{"login":"Microsoft","id":6154722,"avatar_url":"https://avatars.githubusercontent.com/u/6154722?v=3","gravatar_id":"","url":"https://api.github.com/users/Microsoft","html_url":"https://github.com/Microsoft","followers_url":"https://api.github.com/users/Microsoft/followers","following_url":"https://api.github.com/users/Microsoft/following{/other_user}","gists_url":"https://api.github.com/users/Microsoft/gists{/gist_id}","starred_url":"https://api.github.com/users/Microsoft/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Microsoft/subscriptions","organizations_url":"https://api.github.com/users/Microsoft/orgs","repos_url":"https://api.github.com/users/Microsoft/repos","events_url":"https://api.github.com/users/Microsoft/events{/privacy}","received_events_url":"https://api.github.com/users/Microsoft/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/Microsoft/vscode-cpptools2","description":"Repo that holds documentation and tracks issues for the VS Code cpptools extension","fork":false,"url":"https://api.github.com/repos/Microsoft/vscode-cpptools2","forks_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/forks","keys_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/keys{/key_id}","collaborators_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/teams","hooks_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/hooks","issue_events_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/issues/events{/number}","events_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/events","assignees_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/assignees{/user}","branches_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/branches{/branch}","tags_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/tags","blobs_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/git/refs{/sha}","trees_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/git/trees{/sha}","statuses_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/statuses/{sha}","languages_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/languages","stargazers_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/stargazers","contributors_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/contributors","subscribers_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/subscribers","subscription_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/subscription","commits_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/commits{/sha}","git_commits_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/git/commits{/sha}","comments_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/comments{/number}","issue_comment_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/issues/comments{/number}","contents_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/contents/{+path}","compare_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/compare/{base}...{head}","merges_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/merges","archive_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/downloads","issues_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/issues{/number}","pulls_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/pulls{/number}","milestones_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/milestones{/number}","notifications_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/labels{/name}","releases_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/releases{/id}","deployments_url":"https://api.github.com/repos/Microsoft/vscode-cpptools2/deployments","created_at":"2016-08-10T16:46:54Z","updated_at":"2016-08-26T22:25:31Z","pushed_at":"2016-08-29T14:55:04Z","git_url":"git://github.com/Microsoft/vscode-cpptools2.git","ssh_url":"git@github.com:Microsoft/vscode-cpptools2.git","clone_url":"https://github.com/Microsoft/vscode-cpptools2.git","svn_url":"https://github.com/Microsoft/vscode-cpptools2","homepage":"https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools","size":5,"stargazers_count":0,"watchers_count":0,"language":null,"has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":2,"forks":0,"open_issues":2,"watchers":0,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/Microsoft/vscode-cpptools2/pulls/3"},"html":{"href":"https://github.com/Microsoft/vscode-cpptools2/pull/3"},"issue":{"href":"https://api.github.com/repos/Microsoft/vscode-cpptools2/issues/3"},"comments":{"href":"https://api.github.com/repos/Microsoft/vscode-cpptools2/issues/3/comments"},"review_comments":{"href":"https://api.github.com/repos/Microsoft/vscode-cpptools2/pulls/3/comments"},"review_comment":{"href":"https://api.github.com/repos/Microsoft/vscode-cpptools2/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/Microsoft/vscode-cpptools2/pulls/3/commits"},"statuses":{"href":"https://api.github.com/repos/Microsoft/vscode-cpptools2/statuses/db0c60eb25063b757e1bb822c90efefcd2b85005"}}}}
{"actor":{"display_login":"Andrew-MSFT"}}