[libcxx-commits] [libcxx] [libc++] Document our ABI guarantees and what ABI flags exist to modify these guarantees (PR #132615)

[Louis Dionne via libcxx-commits]

https://github.com/ldionne commented:

I think this is a great improvement, thanks for working on it.

This new documentation page appears to mix things that are relevant for different audiences:
- The ABI macros are relevant exclusively to vendors and shouldn't be made part of end user documentation.
- The per-TU guarantees and other ABI stability like structure layout are relevant both to users and to vendors (insofar as they can decide to break such stability via macros).

I think we should probably document those separately, or at least make it very clear what we intend to be user facing and what we don't intend to be user facing.

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