"Debugging the compiler"

[nikomatsakis]

This section should talk about the various tips and tricks for debugging the compiler, as well as perhaps some amount of "debug log conventions". It doesn't necessarily have to be a super long section, but here are some of the things I can think of:

• How to use RUST_LOG and config.toml first and foremost (overlaps with "How to build the compiler and run what you built" #8)
• Some of the handy -Zflags:
  • example: -Ztreat-err-as-bug, which causes errors to be reported as bugs. Useful when you are debugging an error that should not be happening because you can use RUST_BACKTRACE=1 then to get a backtrace of where the error was reported; also avoids dumping out more logs than you need.
  • example: -Zunpretty=hir-tree, which will dump out the HIR
  • example: -Zverbose, which dumps out extra
  • see -Zhelp for more
• Conventions for logs ("loosely followed")
  • Use {:?} most of the time in debug logs
  • I tend to use debug!("foo(...)") at the start of a function foo and debug!("foo: ...") or logs within that function (- nikomatsakis)
• Options to try and correlate node-ids and def-ids with the source
  • e.g., --pretty expanded,identified
• Options to dump the MIR
  • -Zdump-mir and -Zdump-mir-graphviz

[mark-i-m]

cc #78

[nikomatsakis]

I just noticed that there is a page on forge on this topic:

https://forge.rust-lang.org/debugging.html

So, as a start, moving that content into the rustc-guide and removing the page from forge would be easy enough!

[cg-cnu]

Hey @nikomatsakis A rust beginner here and first time contributor to rust project. Might need some help in making the PR, but definitely interested in putting the time and working on it. Can I work on it 🙂

[mark-i-m]

@cg-cnu Definitely! Thanks! Let us know if you need help :)