Author: kotkov
Date: Wed Nov 22 16:03:26 2017
New Revision: 1816066
URL: http://svn.apache.org/viewvc?rev=1816066&view=rev
Log:
* subversion/include/svn_delta.h
(svn_delta_editor_t): Tweak the ABI compatibility note, as discussed in
https://lists.apache.org/thread.html/bd846a6600de200553b607daaab7a20440505bfe136a976493e3b501@%3Cdev.subversion.apache.org%3E
Modified:
subversion/trunk/subversion/include/svn_delta.h
Modified: subversion/trunk/subversion/include/svn_delta.h
URL:
http://svn.apache.org/viewvc/subversion/trunk/subversion/include/svn_delta.h?rev=1816066&r1=1816065&r2=1816066&view=diff
==============================================================================
--- subversion/trunk/subversion/include/svn_delta.h (original)
+++ subversion/trunk/subversion/include/svn_delta.h Wed Nov 22 16:03:26 2017
@@ -693,12 +693,11 @@ svn_txdelta_skip_svndiff_window(apr_file
/** A structure full of callback functions the delta source will invoke
* as it produces the delta.
*
- * @note Fields may be added to the end of this structure in future
- * versions. Therefore, users shouldn't allocate structures of this
- * type, to preserve binary compatibility.
- *
- * @note It is recommended to use svn_delta_default_editor() or some other
- * constructor, to ensure that unused slots are filled in with no-op functions.
+ * @note Don't try to allocate one of these yourself. Instead, always
+ * use svn_delta_default_editor() or some other constructor, to avoid
+ * backwards compatibility problems if the structure is extended in
+ * future releases and to ensure that unused slots are filled in with
+ * no-op functions.
*
* <h3>Function Usage</h3>
*
