From 18bebcc3bee7eb75f92896210eca68b4b2094426 Mon Sep 17 00:00:00 2001
From: Andreas Heissenberger <andreas@heissenberger.at>
Date: Fri, 4 Jun 2021 16:55:22 +0200
Subject: [PATCH] docs: add info on how to setup VSCode for debugging V code
 (#10329)

---
 doc/docs.md                 |  28 +++++++++--
 doc/img/vscode-debugger.png | Bin 0 -> 7284 bytes
 doc/vscode.md               |  90 ++++++++++++++++++++++++++++++++++++
 3 files changed, 115 insertions(+), 3 deletions(-)
 create mode 100644 doc/img/vscode-debugger.png
 create mode 100644 doc/vscode.md

diff --git a/doc/docs.md b/doc/docs.md
index 4a0b1e8d06..3735f8547c 100644
--- a/doc/docs.md
+++ b/doc/docs.md
@@ -129,7 +129,7 @@ For more details and troubleshooting, please visit the [vab GitHub repository](h
     * [Structs with reference fields](#structs-with-reference-fields)
     * [sizeof and __offsetof](#sizeof-and-__offsetof)
     * [Calling C from V](#calling-c-from-v)
-    * [Debugging generated C code](#debugging-generated-c-code)
+    * [Debugging](#debugging)
     * [Conditional compilation](#conditional-compilation)
     * [Compile time pseudo variables](#compile-time-pseudo-variables)
     * [Compile-time reflection](#compile-time-reflection)
@@ -3825,9 +3825,11 @@ re-creating the original structure exactly.
 Alternatively, you may [embed](#embedded-structs) the sub-data-structures to maintain
 a parallel code structure.
 
-## Debugging generated C code
+## Debugging
 
-To debug issues in the generated C code, you can pass these flags:
+### C Backend binaries (Default) 
+
+To debug issues in the generated binary (flag: `-b c`), you can pass these flags:
 
 - `-g` - produces a less optimized executable with more debug information in it.
     V will enforce line numbers from the .v files in the stacktraces, that the
@@ -3860,6 +3862,26 @@ for example `main`, you can use: `-printfn main -o file.c`.
 To see a detailed list of all flags that V supports,
 use `v help`, `v help build` and `v help build-c`.
 
+**Commandline Debugging**
+
+1. compile your binary with debugging info `v -g hello.v`
+2. debug with [lldb](https://lldb.llvm.org) or [GDB](https://www.gnu.org/software/gdb/) e.g. `lldb hello`
+
+Troubleshooting (debugging) executables [created with V in GDB](https://github.com/vlang/v/wiki/Troubleshooting-(debugging)-executables-created-with-V-in-GDB)
+
+**Visual debugging Setup:**
+* [Visual Studio Code](vscode.md)
+
+### Native Backend binaries
+
+Currently there is no debugging support for binaries created by the native backend (flag: `-b native`).
+
+### Javascript Backend
+
+There is currently no support for source maps for Javascript output create by the JS Backend (flag: `-b js`).
+
+
+
 ## Conditional compilation
 
 ### Compile time code
diff --git a/doc/img/vscode-debugger.png b/doc/img/vscode-debugger.png
new file mode 100644
index 0000000000000000000000000000000000000000..ff3b7996cdba9cc0743e8665ddd2d4b51aca532e
GIT binary patch
literal 7284
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

literal 0
HcmV?d00001

diff --git a/doc/vscode.md b/doc/vscode.md
new file mode 100644
index 0000000000..3f990c020d
--- /dev/null
+++ b/doc/vscode.md
@@ -0,0 +1,90 @@
+# Visual Studio Code Setup
+
+## Table of Contents
+
+* [V language support](#v-language-support)
+* [Visual Debugging](#visual-debugging)
+
+## V language support
+
+The [V VS Code Extention](https://marketplace.visualstudio.com/items?itemName=vlanguage.vscode-vlang) provides V language support for Visual Studio Code.
+
+![Screenshot Code with activated extention](https://github.com/vlang/vscode-vlang/raw/HEAD/images/demo.png)
+
+**Features:**
+* Syntax Highlighting.
+* Code Snippets for quick coding.
+* Format code on file save as well as format manually (using v fmt).
+* Linter (Workspace files only).
+[more](https://marketplace.visualstudio.com/items?itemName=vlanguage.vscode-vlang)
+
+**Hint:** This extention will not add the V compiler! Information on how to [install V compiler](https://github.com/vlang/v/blob/master/doc/docs.md#install-from-source) on your operating system.
+
+### Setup
+
+Install [V VS Code Extention](https://marketplace.visualstudio.com/items?itemName=vlanguage.vscode-vlang).
+
+## Visual Debugging
+
+![screenshot visual debugger](https://github.com/vlang/v/blob/master/doc/img/vscode-debugger.png?raw=true)
+
+The [C/C++ Extention](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools) for Visual Studio Code provides visual conditional debugging.
+
+**Features:**
+* Conditional breakpoints
+* Function breakpoints
+* Expression evaluation
+* Change Values
+[more Features & Documentation](https://code.visualstudio.com/docs/cpp/cpp-debug)
+
+**Hint:** Not all types (e.g. Array) in V currently create the required [DWARF](https://en.wikipedia.org/wiki/DWARF) information to show and edit the variable.
+
+### Setup
+
+1. Install the [C/C++ Extention](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools)
+2. Open `RUN AND DEBUG` panel (Debug Icon in left panel).
+3. Click on `Show` all automatic debug configurations.
+4. Select `Add config`.
+5. Select environment `C++ (GDB/LLDB)`.
+6. Change the line `"program": "Programmnamen eingeben, z. B. \"${workspaceFolder}/a.out\"",` to point to your compiled application e.g. `"program": "${workspaceFolder}/hello",`.
+
+This will add a block to your `.workspace` file or creates the file `.vscode/launch.json`:
+```json
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "(lldb) Starten",
+            "type": "cppdbg",
+            "request": "launch",
+            "program": "Programmnamen eingeben, z. B. \"${workspaceFolder}/a.out\"",
+            "args": [],
+            "stopAtEntry": false,
+            "cwd": "${fileDirname}",
+            "environment": [],
+            "externalConsole": false,
+            "MIMode": "lldb"
+        }
+    ]
+}
+```
+
+### Usage
+
+To allow your compiled application to be debugged. The application needs to include additional debugging information ([DWARF](https://en.wikipedia.org/wiki/DWARF)).
+
+**1. Compile with debugging information:**
+`v -b c -g hello.v -o hello` or short `v -g hello.v`
+
+The `-g` option will add the needed debugging informations.  More Options are explained in the [docs](docs.md#debugging).
+
+
+**2. Start Debugging**
+
+1. Open your source code and set the required break points
+2. Click on the Debug Icon in the left Icon panel and klick `> (lldb) Start` or use `F5` to launch your application in debug mode.
+
+For all options look at the official [C/C++ Extention documentation](https://code.visualstudio.com/docs/cpp/cpp-debug).
\ No newline at end of file