[clang] [Doc] Update documentation for no-transitive-change (PR #96453)

Ilya Biryukov via cfe-commits cfe-commits at lists.llvm.org
Wed Jun 26 09:08:18 PDT 2024


================
@@ -652,6 +652,134 @@ in the future. The expected roadmap for Reduced BMIs as of Clang 19.x is:
    comes, the term BMI will refer to the Reduced BMI and the Full BMI will only
    be meaningful to build systems which elect to support two-phase compilation.
 
+Experimental No Transitive Change
----------------
ilya-biryukov wrote:

On "experimental": thanks for clarifying that you meant this as "experimental in the build system".
I am afraid that the current wording actually does the opposite and tells that this the compiler support is "experimental" (aka "unstable", aka "don't touch this until it stabilizes").

On "no transitive change": I'm also not a native speaker, but this did sound weird to me as well. So +1 to changing this.
"Better isolation of BMI" would be my preferred option. "Better" communicates that the isolation is imperfect (in shades of gray rather than black and white), so I wouldn't expect that to cause any confusion. +

https://github.com/llvm/llvm-project/pull/96453


More information about the cfe-commits mailing list