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

[Nikolas Klauser via libcxx-commits]

philnik777 wrote:

> 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.

I'm not sure where you'd like to draw the distinction. I don't think that it makes a ton of sense to move the description of the ABI flags into a different document, since that's just going to either duplicate the documentation or make it incredibly hard to read. 

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