Recommend debug-logging instead of debug

This makes the compiler faster to running without sacrificing too much
performance. It still shows logging so contributors aren't confused by
`debug!` doing nothing.

src/building/how-to-build-and-run.md

@@ -37,28 +37,15 @@ settings (and possibly others, such as `llvm.ccache`):
 assertions = true
 
 [rust]
-# Indicates that the build should be configured for debugging Rust. A
+# Whether or not to leave debug! and trace! calls in the rust binary.
-# `debug`-enabled compiler and standard library will be somewhat
+# Overrides the `debug-assertions` option, if defined.
-# slower (due to e.g. checking of debug assertions) but should remain
-# usable.
 #
-# Note: If this value is set to `true`, it will affect a number of
+# Defaults to rust.debug-assertions value
-#       configuration options below as well, if they have been left
-#       unconfigured in this file.
 #
-# Note: changes to the `debug` setting do *not* affect `optimize`
+# If you see a message from `tracing` saying
-#       above. In theory, a "maximally debuggable" environment would
+# `max_level_info` is enabled and means logging won't be shown,
-#       set `optimize` to `false` above to assist the introspection
+# set this value to `true`.
-#       facilities of debuggers like lldb and gdb. To recreate such an
+debug-logging = true
-#       environment, explicitly set `optimize` to `false` and `debug`
-#       to `true`. In practice, everyone leaves `optimize` set to
-#       `true`, because an unoptimized rustc with debugging
-#       enabled becomes *unusably slow* (e.g. rust-lang/rust#24840
-#       reported a 25x slowdown) and bootstrapping the supposed
-#       "maximally debuggable" environment (notably std) takes
-#       hours to build.
-#
-debug = true
 
 # Whether to always use incremental compilation when building rustc
 incremental = true