<div dir="ltr">At the risk of overstepping...this is open-source software. You never prevent anyone from using any bits that they like. All you're doing by annotating or otherwise hiding things is saying that such code may not exist in future releases, which may or may not be important for users. People who are going to use "private" bits are almost by definition taking some responsibility for integration and upgrades if they desire them.</div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, Dec 7, 2022 at 10:05 AM Daniel Baston <<a href="mailto:dbaston@gmail.com">dbaston@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><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>
_______________________________________________<br>
geos-devel mailing list<br>
<a href="mailto:geos-devel@lists.osgeo.org" target="_blank">geos-devel@lists.osgeo.org</a><br>
<a href="https://lists.osgeo.org/mailman/listinfo/geos-devel" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/geos-devel</a><br>
</blockquote></div><br clear="all"><div><br></div>-- <br><div dir="ltr" class="gmail_signature">Andrew Bell<br><a href="mailto:andrew.bell.ia@gmail.com" target="_blank">andrew.bell.ia@gmail.com</a></div>