Document -Zno-parallel-llvm.

Because it's usefulness wasn't clear to me, and I initially wondered if
it could be removed. The text is based on the text in #50972, the PR
that added the flag.
This commit is contained in:
Nicholas Nethercote 2023-07-21 08:58:08 +10:00
parent 67e4bec200
commit 0ea9950ede

View File

@ -0,0 +1,8 @@
# `no-parallel-llvm`
---------------------
This flag disables parallelization of codegen and linking, while otherwise preserving
behavior with regard to codegen units and LTO.
This flag is not useful for regular users, but it can be useful for debugging the backend. Codegen issues commonly only manifest under specific circumstances, e.g. if multiple codegen units are used and ThinLTO is enabled. Serialization of these threaded configurations makes the use of LLVM debugging facilities easier, by avoiding the interleaving of output.