ChuanqiXu9 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.
How about adding a sentence like "this section is primarily for build system vendors. For end compiler users, if you don't want to read it all, this is helpful to reduce recompilations. We encourage build system vendors and end users try this out and bring feedbacks"? https://github.com/llvm/llvm-project/pull/96453 _______________________________________________ cfe-commits mailing list cfe-commits@lists.llvm.org https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits