API stability

[czchen]

When preparing 1.3.3 for debian, I found that two APIs r3_route_create and r3_tree_insert_pathl are removed. Also, several APIs like zcalloc, zfree are exported in 1.3.1. Since library API change requires transitions, is there any plan to provide stable API and hide private functions from exporting in next version?

[c9s]

I just checked and found route * r3_route_create(const char * path) is still there. ^^

[c9s]

r3_tree_insert_pathl is now a macro, which calls r3_tree_insert_pathl_ex to insert path.

[c9s]

is there any plan to provide stable API and hide private functions from exporting in next version?

yes, but I think it's something we will do 3+ month later. :-)

zmalloc related functions were moved into 3rdparty directory, I think we can remove the exported symbol.

[czchen]

Sorry, the term API is misunderstood. I actual want to say is ABI (application binary interface). Since r3_route_create is macro, it is not part of ABI.

For ABI, you can use prefix like r3 and use -export-symbols-regex to limit the exported symbols so that it won't cause any symbol collision.

[c9s]

Got it. is it also a policy of the debian package system?

[czchen]

API name suggestion is not related to debian. The purpose of API name with prefix r3 is to let developer use different libraries without worrying about API name collision.

[c9s]

Hi @czchen,

I think I would plan/refactor the stable API in version 2.0 (including hide the zfree ... functions)

[czchen]

Hi @c9s,

No problem. Just don't forget to bump so version so that it is more easily to do the incompatibility upgrade.