Merge pull request commercialhaskell#5098 from flip111/patch-7

snoyberg · web-flow · commit ef364ea6b082 · 2020-01-07T06:40:12.000+02:00
Update GUIDE.md about debugging symbols
diff --git a/doc/GUIDE.md b/doc/GUIDE.md
@@ -1819,13 +1819,11 @@ To generate a backtrace in case of exceptions during a test or benchmarks run,
 use the `--trace` flag. Like `--profile` this compiles with profiling options,
 but adds the `+RTS -xc` runtime option.
 
-### DWARF
+### Debugging symbols
 
-`stack` now supports debugging and profiling with
-[DWARF information](https://ghc.haskell.org/trac/ghc/wiki/DWARF),
-using the `--no-strip`, `--no-library-stripping`, and `--no-executable-stripping`
-flags to disable the default behavior of removing such information from compiled
-libraries and executables.
+Building with debugging symbols in the [DWARF information](https://ghc.haskell.org/trac/ghc/wiki/DWARF) is supported by `stack`. This can be done by passing the flag `--ghc-options="-g"` and also to override the default behaviour of stripping executables of debugging symbols by passing either one of the following flags: `--no-strip`, `--no-library-stripping` or `--no-executable-stripping`.
+
+In Windows GDB can be isntalled to debug an executable with `stack exec -- pacman -S gdb`. Windows visual studio compiler's debugging format PDB is not supported at the moment. This might be possible by [separating](https://stackoverflow.com/questions/866721/how-to-generate-gcc-debug-symbol-outside-the-build-target) debugging symbols and [converting](https://github.com/rainers/cv2pdb) their format. Or as an option when [using the LLVM backend](http://blog.llvm.org/2017/08/llvm-on-windows-now-supports-pdb-debug.html).
 
 ## More resources
 
