Add some text about potential incompatibilites with 2.7.x releases

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@40495 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

diff --git a/docs/publicity/announce.txt b/docs/publicity/announce.txt
index fee2ac2f6139635a1b5264e38105473bac1e0732..7129a0771142e9c01a3abf5bfdce49f6d08e2236 100644 (file)
--- a/docs/publicity/announce.txt
+++ b/docs/publicity/announce.txt
@@ -22,11 +22,16 @@ To get wxWidgets, please go to the Download page at:
 
   http://www.wxwidgets.org/
 
-This is the first version in the new 2.7 series. Please notice
-that this series is called "development" and not "stable" solely
-because compatibility is not assured among between different 2.7
-series versions but there are no known issues with the stability
-of the programs using this version.
+This is the first version in the new 2.7 development series. Please
+notice that this series is called "development" and not "stable"
+solely because ABI or API compatibility is not assured between
+different 2.7.x series versions.  Rest assured however that these
+potentially incompatible changes are made in order to evolve the
+toolkit to the next ABI stable release series (2.8.x) and that
+normally efforts are made to preserve compilation compatibility, so
+often moving to a new development release just requires a full
+recompile of the application using wxWidgets.  There are currently no
+known issues with the stability of the programs using this version.
 
 There have been many changes since the 2.6 series, please see the
 change log file included in the distribution for more details. The

diff --git a/docs/readme.txt b/docs/readme.txt
index cf5e84e8a196f2950129dbb6d938b633bd0d6d51..db2aee3c64cdcd7f2fd7d4f98d1f9d108378716a 100644 (file)
--- a/docs/readme.txt
+++ b/docs/readme.txt
@@ -19,6 +19,21 @@ and Windows Help form: see the docs hierarchy.
 For a quick start, point your Web browser at docs/html/index.htm
 for a list of important documents and samples.
 
+Releases in the 2.7 series are considered development releases,
+and as such, each new release may contain significant new
+features or code changes which have not yet received thorough
+testing and/or may break ABI or API compatibility with previous
+releases. Therefore, we recommend that you keep this in mind if
+you are to base your software on a 2.7 release, and thoroughly
+test the parts of the wx library your application uses.  Rest
+assured however that these potentially incompatible changes are
+made in order to evolve the toolkit to the next ABI stable
+release series (2.8.x) and that normally efforts are made to
+preserve compilation compatibility, so often moving to a new
+development release just requires a full recompile of the
+application using wxWidgets.
+
+
 Changes in this release
 -----------------------