From 18bc0a38ab5b2984082add0751a19b0ba75807ef Mon Sep 17 00:00:00 2001
From: Martin Quinson <martin.quinson@ens-rennes.fr>
Date: Sat, 16 Mar 2019 00:27:51 +0100
Subject: [PATCH] Improve the ChangeLog & NEWS in preparation for the release

Please people, document your changes.

The item of NEWS about XBT could be replaced by something more
interesting and visible to the users, if any.
---
 ChangeLog | 29 +++++++++++++++++++----------
 NEWS      |  6 ++++++
 2 files changed, 25 insertions(+), 10 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 28d9dd1594..a1b664aae9 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,9 +1,13 @@
 SimGrid (3.22) NOT RELEASED (Release Target: December 21. 2018, 22:23 UTC)
 
-Java:
- - Process termination which was broken at version 3.21 has been repaired.
- - Expose host load plugin: loadInit, getCurrentLoad, getComputedFlops, getAvgLoad
- - Hide the examples into examples/deprecated. New users should use Python.
+The Sneaky Release.
+
+Python:
+ - We are excited to introduce the SimGrid/S4U interface to your neighborhood
+ - Not complete yet: asynchronous activities (amongst others) are still missing
+ - Still ongoing: the interface may change a bit in the future (please
+   report any glitches), but it seems rather fast and reliable already. 
+ - Forget about Java now (and soon about C++)
 
 Core:
  - Replace our own code to display a backtrace (that was forking addr2line)
@@ -12,6 +16,15 @@ Core:
  - Bump cmake dependency to 3.5 (provided by Ubuntu 16.04).
  - Stop setting random seed with srand() at initialization.
 
+XML
+ - In <host> and <peer>, 'availability_file' is now 'speed_file'.
+   XML file version remains 4.2 since old files are still compatible.
+
+Java:
+ - Process termination which was broken at version 3.21 has been repaired.
+ - Expose host load plugin: loadInit, getCurrentLoad, getComputedFlops, getAvgLoad
+ - Hide the examples into examples/deprecated. New users should use Python.
+
 MSG:
  - Drop MSG_process_create_from_stdfunc() from the API.
    This C++ function was a pimple in the C API, made necessary at some
@@ -37,16 +50,12 @@ XBT:
  - Drop xbt_ex_display(), use simgrid::xbt::log_exception() instead.
  - Drop cunit, use Catch2 instead.
 
-XML
- - In <host> and <peer>, availability_file is now speed_file.
-   XML file version remains 4.2 since old files are still compatible.
-
-Internal:
+Kernel:
  - Many cleanups in the kernel::activity namespace. This was long
    overdue, and shall open the path to many future endeavors.
 
 Fixed bugs:
- - #132: Java : a process can not shut down its own host
+ - #132: Java: a process can not shut down its own host
  - #261: Document the parameters of parallel execution's constructor
  - #300: [s4u] BarrierPtr is missing
  - #314: SMPI args internal cleanup
diff --git a/NEWS b/NEWS
index c5a113b0db..911758ee2a 100644
--- a/NEWS
+++ b/NEWS
@@ -5,6 +5,12 @@ __   _____ _ __ ___(_) ___  _ __   |___ / |___ \|___ \
   \_/ \___|_|  |___/_|\___/|_| |_| |____(_)_____|_____|
                (not released)
 
+The Sneaky Release.
+
+ * Introducing the Python bindings (still partial)
+ * Doc: SMPI tutorial and platform description ported to RTD
+ * Further replace XBT by the std library.
+ * (+ the classical bug fixes and internal refactorings)
                     _               _____  ____  _
 __   _____ _ __ ___(_) ___  _ __   |___ / |___ \/ |
 \ \ / / _ \ '__/ __| |/ _ \| '_ \    |_ \   __) | |
-- 
2.20.1