Author: danielsh
Date: Sat Sep 2 08:05:40 2017
New Revision: 1807028
URL: http://svn.apache.org/viewvc?rev=1807028&view=rev
Log:
* subversion/include/svn_delta.h
(svn_delta_editor_t): Clarify that users shouldn't allocate structs of this
type.
Thread:
https://mail-archives.apache.org/mod_mbox/subversion-dev/201708.mbox/%3C1504069641.1484831.1089380968.136144BB%40webmail.messagingengine.com%3E
From: Daniel Shahaf
To: dev@
Subject: Re: svn commit: r1803143 - in /subversion/trunk/subversion:
include/ libsvn_delta/ libsvn_ra_serf/ mod_dav_svn/
Date: Wed, 30 Aug 2017 05:07:21 GMT
Message-ID:
<1504069641.1484831.1089380968.13614...@webmail.messagingengine.com>
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=1807028&r1=1807027&r2=1807028&view=diff
==============================================================================
--- subversion/trunk/subversion/include/svn_delta.h (original)
+++ subversion/trunk/subversion/include/svn_delta.h Sat Sep 2 08:05:40 2017
@@ -693,9 +693,12 @@ svn_txdelta_skip_svndiff_window(apr_file
/** A structure full of callback functions the delta source will invoke
* as it produces the delta.
*
- * @note Don't try to allocate one of these yourself. Instead, always
- * use svn_delta_default_editor() or some other constructor, to ensure
- * that unused slots are filled in with no-op functions.
+ * @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.
*
* <h3>Function Usage</h3>
*
