subversion-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From kot...@apache.org
Subject svn commit: r1816066 - /subversion/trunk/subversion/include/svn_delta.h
Date Wed, 22 Nov 2017 16:03:26 GMT
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>
  *



Mime
View raw message