Wrote blurb for 5.0.0

git-svn-id: file:///Volumes/GecodeGitMigration/gecode-svn-mirror/gecode/trunk@15223 e85b7adc-8362-4630-8c63-7469d557c915

Author: Christian Schulte

changelog.in

@@ -68,9 +68,25 @@
 
 [RELEASE]
 Version: 5.0.0
-Date: 2015-?-?
+Date: 2016-10-31
 [DESCRIPTION]
-Gaga
+
+This release adds a number of new features and fixes many bugs
+(some rather serious), so it is recommended to switch as soon as
+possible to this release. Some highlights are: re-added limited
+discrepancy search (LDS); added sequential and parallel
+portfolio-based search (PBS); added support for groups of
+propagators and branchers; added extensive tracing functionality
+based on groups; propagators can be disabled and re-enabled;
+support for arbitrary memory allocators; changed the notion of
+"integer consistency level" to the more expressive concept
+"integer propagation level".
+
+It is recommended to read the new Chapter in MPG on groups and
+tracing.
+
+As the interfaces has changed, please consult
+\ref PageHowToChange_5 "How to Change to Gecode 5.0.0".
 
 [ENTRY]
 Module: float

doxygen/doxygen.hh.in

@@ -621,4 +621,32 @@ have run into division by zero issues. And just changing the
 implementation is not good enough because the values of these
 measures can now be exposed during tie-breaking.
 
+
+/**
+ * \page PageHowToChange_5 How to Change from %Gecode 4.4.0 to %Gecode 5.0.0
+ *
+
+As %Gecode 5.0.0 is a major revision, your programs that
+are written for %Gecode 4.4.0 are likely to require some
+modifications, yet very few, before they work again.
+
+\section SecChange5Handle Removed Brancher Handles
+
+Brancher handles have been removed as they can be expressed
+easily by brancher groups, please consult MPG for details.
+
+\section SecChange5IPL New Integer Propagation Levels
+
+The concept of integer consistency level "IntConLevel" has been
+replaced by integer propagation level "IntPropLevel". In most cases
+it should be sufficient to:
+ - search and replace ICL_ by IPL_.
+ - search and replace IntConLevel by IntPropLevel.
+ - use the commandline option -ipl rather than -icl.
+
+Integer propagation levels are more expressive than integer
+consistency levels. They can also express other propagation
+preferences such as speed, memory, basic, or advanced. Please
+consult MPG for details.
+
 */