<div dir="ltr">That's fascinating. It didn't show up like that in my editor.<div><br></div><div>I'll fix. Thanks!</div><div><br></div><div>-eric</div></div><br><div class="gmail_quote"><div dir="ltr">On Thu, Dec 10, 2015 at 1:39 PM Rafael Espíndola <<a href="mailto:rafael.espindola@gmail.com">rafael.espindola@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">> +* Stability Guarantees: The C API is, in general, a â€œbest effort† for stability.<br>
<br>
May use ASCII " here and in a few other places?<br>
<br>
Cheers,<br>
Rafael<br>
<br>
<br>
<br>
> +This means that we make every attempt to keep the C API stable, but that<br>
> +stability will be limited by the abstractness of the interface and the stability<br>
> +of the C++ API that it wraps. In practice, this means that things like â€œcreate<br>
> +debug info† or â€œcreate this type of instruction† are likely to be less stable<br>
> +than â€œtake this IR file and JIT it for my current machine†.<br>
> +<br>
> +* Release stability: We won’t break the C API on the release branch with patches<br>
> +that go on that branch, with the exception that if we will fix an unintentional<br>
> +C API break that will keep the release consistent with both the previous and next<br>
> +release.<br>
> +<br>
> +* Testing: Patches to the C API are expected to come with tests just like any<br>
> +other patch.<br>
> +<br>
> +* Including new things into the API: If an LLVM subcomponent has a C API already<br>
> +included, then expanding that C API is acceptable. Adding C API for subcomponents<br>
> +that don't currently have one is fine, and the details of how best to design that<br>
> +API should be discussed on the mailing list.<br>
> +<br>
> +* Documentation: Any changes to the C API are required to be documented in the<br>
> +release notes so that it’s clear to external users who do not follow the project<br>
> +how the C API is changing and evolving.<br>
> +<br>
>  .. _copyright-license-patents:<br>
><br>
>  Copyright, License, and Patents<br>
><br>
><br>
> _______________________________________________<br>
> llvm-commits mailing list<br>
> <a href="mailto:llvm-commits@lists.llvm.org" target="_blank">llvm-commits@lists.llvm.org</a><br>
> <a href="http://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-commits" rel="noreferrer" target="_blank">http://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-commits</a><br>
</blockquote></div>