<div dir="ltr"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="auto"><div dir="auto">Do you build a shared library? If so, limit what you export to what you want to be your API. Don't document anything else.</div><div dir="auto"><br></div><div dir="auto">Maybe I'm missing something in what you're asking.</div></div></blockquote><div><br></div><div>I don't think you're missing anything, and these are routes we could take. I am inclined to look for a solution that flags "stable" methods but doesn't actually prevent the user from using methods not flagged as such. For example, we could flag all non-stable methods in such a way that a compiler warning is generated unless the user has defined "USE_NON_STABLE_API" or whatever it's called. But since the unstable methods will greatly outnumber the stable ones, it would be nice to have something that didn't require us to put an extra directive all over the place.<br></div><div><br></div><div>Dan<br></div></div></div>