[clang] [Doc] Update documentation for no-transitive-change (PR #96453)
Ilya Biryukov via cfe-commits
cfe-commits at lists.llvm.org
Mon Jun 24 07:57:20 PDT 2024
ilya-biryukov wrote:
I really like the idea of documenting this, hopefully this create some fruitful discussions with the build system developers and other compiler users.
After trying to put myself into the shoes of the compiler users reading this, I can't help but think that the "no transitive changes" is slightly confusing and hard to grasp. The example does help quite a bit, but I also feel there should be a way to document this in shorter form. (E.g. we can double-down on the "this is a build optimization" angle and being explicit that we want people to try this and let them know how to report bugs about it?)
I wanted to take a little bit of time to think how to do it before providing concrete suggestions, but still wanted to mention this.
https://github.com/llvm/llvm-project/pull/96453
More information about the cfe-commits
mailing list