API review for 1.11; do we need to mark new APIs as experimental?
From: Julian Foad <julianfoad_at_apache.org>
Date: Wed, 12 Sep 2018 20:21:26 +0100
The following public APIs are new or revved since 1.10:
svn_client_layout_func_t
svn_client_diff7
svn_client_revert4
svn_client_conflict_option_id_t
svn_client_shelf_*
SVN_OPT_MAX_PARAGRAPHS
** QUESTION **
We recently decided that only APIs released in an LTS release will be subject to our compatibility guarantees. As 1.11 is not an LTS release, the above APIs will not be subject to those guarantees (until they appear in an LTS).
Do we need to do anything in the source code to emphasize that, for the ones that are not already marked 'experimental'? If so, what? Mark them 'experimental' in addition to their existing annotations (which probably would mean we'd want to turn off the warnings about use of experimental APIs in our own builds), or something else?
We should certainly mention this explicitly in the 1.11 release notes.
-- - JulianReceived on 2018-09-12 21:21:33 CEST |
This is an archived mail posted to the Subversion Dev mailing list.
This site is subject to the Apache Privacy Policy and the Apache Public Forum Archive Policy.