about summary refs log tree commit diff
path: root/config.toml.example
diff options
context:
space:
mode:
authorManish Goregaokar <manishsmail@gmail.com>2020-07-10 23:26:32 -0700
committerGitHub <noreply@github.com>2020-07-10 23:26:32 -0700
commit2ae7d8cdba4ee8584bdcdcd22699d151a6b8959f (patch)
tree420e09f4c1df2314f79065dff7040309d9b698a5 /config.toml.example
parentef3dc09fa7078d36ea5831ee9a3eb5c335cdb2f3 (diff)
parentbcef848a6971217d4b8df50c17e047174018d316 (diff)
Rollup merge of #74045 - tmiasko:config-debug, r=nikomatsakis
Explain effects of debugging options from config.toml
Diffstat (limited to 'config.toml.example')
-rw-r--r--config.toml.example8
1 files changed, 6 insertions, 2 deletions
diff --git a/config.toml.example b/config.toml.example
index 2fa613755d6..79e4e46d85b 100644
--- a/config.toml.example
+++ b/config.toml.example
@@ -318,7 +318,9 @@
 #codegen-units-std = 1
 
 # Whether or not debug assertions are enabled for the compiler and standard
-# library.
+# library. Debug assertions control the maximum log level used by rustc. When
+# enabled calls to `trace!` and `debug!` macros are preserved in the compiled
+# binary, otherwise they are omitted.
 #
 # Defaults to rust.debug value
 #debug-assertions = false
@@ -331,7 +333,9 @@
 
 # Debuginfo level for most of Rust code, corresponds to the `-C debuginfo=N` option of `rustc`.
 # `0` - no debug info
-# `1` - line tables only
+# `1` - line tables only - sufficient to generate backtraces that include line
+#       information and inlined functions, set breakpoints at source code
+#       locations, and step through execution in a debugger.
 # `2` - full debug info with variable and type information
 # Can be overridden for specific subsets of Rust code (rustc, std or tools).
 # Debuginfo for tests run with compiletest is not controlled by this option