================ @@ -373,19 +373,21 @@ implementation of the facilities by Clang may change behavior as bugs are fixed, features get implemented, etc. The library should be ABI and API stable over time, but ABI- and API-breaking -changes can happen in the following situations: +changes can happen in the following (non-exhaustive) situations: * Adding new enumerator to an enumeration (can be ABI-breaking in C++). * Removing an explicitly deprecated API after a suitably long deprecation period. -* Uses of implementation details, such names or comments that say something is - "private", "reserved", "internal", etc. +* Using implementation details, such as names or comments that say something + is "private", "reserved", "internal", etc. +* Bug fixes or changes to Clang's internal implementation, or (rarely), bug ---------------- Endilll wrote:
Thank you for reminding me of the discussion we had sometime last year. We can write this down, but I'm not sure how good we are at enforcing this, because stable libclang API is implemented on top of unstable C++ API. https://github.com/llvm/llvm-project/pull/141657 _______________________________________________ cfe-commits mailing list cfe-commits@lists.llvm.org https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits