X-Git-Url: https://git.lizzy.rs/?a=blobdiff_plain;f=config.toml.example;h=01952b21ba4b1fe9a07f76b246b65e3a0151760c;hb=8cb94fc552dc200e19001b40767c0c279572c9de;hp=2fa613755d64c45e46a3e795ea5e8a01931681ca;hpb=d82588b45aa866418a3cc88924e939015fd1bd1c;p=rust.git

diff --git a/config.toml.example b/config.toml.example
index 2fa613755d6..01952b21ba4 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
@@ -387,8 +391,7 @@
 # desired in distributions, for example.
 #rpath = true
 
-# Emits extraneous output from tests to ensure that failures of the test
-# harness are debuggable just from logfiles.
+# Emits extra output from tests so test failures are debuggable just from logfiles.
 #verbose-tests = false
 
 # Flag indicating whether tests are compiled with optimizations (the -O flag).