Skip to content

Commit 9e6c1d1

Browse files
committed
Make it more clear the list is not exhaustive, talk about bug fixes
1 parent af20153 commit 9e6c1d1

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

clang/docs/LibClang.rst

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -373,13 +373,15 @@ implementation of the facilities by Clang may change behavior as bugs are
373373
fixed, features get implemented, etc.
374374

375375
The library should be ABI and API stable over time, but ABI- and API-breaking
376-
changes can happen in the following situations:
376+
changes can happen in the following (non-exhaustive) situations:
377377

378378
* Adding new enumerator to an enumeration (can be ABI-breaking in C++).
379379
* Removing an explicitly deprecated API after a suitably long deprecation
380380
period.
381381
* Using implementation details, such as names or comments that say something
382382
is "private", "reserved", "internal", etc.
383+
* Bug fixes or changes to Clang's internal implementation, or (rarely), bug
384+
fixes to libclang itself.
383385

384386
The library has version macros (``CINDEX_VERSION_MAJOR``,
385387
``CINDEX_VERSION_MINOR``, and ``CINDEX_VERSION``) which can be used to test for

0 commit comments

Comments
 (0)