Update the list of changes before 3.1.2 release

Update both the (more detailed) README and the (shorter) announcement
message.

Also update the statistics and the cumulated changes since 3.0.

docs/publicity/announce.txt

@@ -1,39 +1,44 @@
-February 19, 2018 -- The wxWidgets team is pleased to announce a new
+December 10, 2018 -- The wxWidgets team is pleased to announce a new
 release of our open source framework for the development of native
 cross-platform applications in C++.
 
-wxWidgets 3.1.1 is the second release in the 3.1 development
+wxWidgets 3.1.2 is the latest release in the 3.1 development
 branch and is now available at
 
-    https://github.com/wxWidgets/wxWidgets/releases/tag/v3.1.1
+    https://github.com/wxWidgets/wxWidgets/releases/tag/v3.1.2
 
 Compared to the stable 3.0.x series, this version brings many
 improvements and even more bug fixes, please see the change log
 
-https://raw.githubusercontent.com/wxWidgets/wxWidgets/v3.1.1/docs/changes.txt
+https://raw.githubusercontent.com/wxWidgets/wxWidgets/v3.1.2/docs/changes.txt
 
 for the incomplete list of the most important ones. Here is the
 maximally condensed summary of the changes compared to 3.0:
 
+- Build system improvements: support for new compilers (MSVS 2017, g++ 8) and
+  OS versions (macOS 10.14 and its dark mode) as well as an entirely new new
+  CMake build system.
 - New features: support for mouse gesture events (GSoC 2017 project);
-  fractional pen widths in wxGraphicsContext; arbitrary label windows in
+  non-integer font sizes and arbitrary font weights in wxFont; fractional pen
-  wxStaticBox; markup in wxDataViewCtrl items text; better support for high DPI
+  widths in wxGraphicsContext; arbitrary label windows in wxStaticBox; markup
-  monitors; support for ZIP 64 files; much improved accessibility support under
+  in wxDataViewCtrl items text; better support for high DPI monitors; support
+  for ZIP 64 files; LZMA compression; much improved accessibility support under
   MSW.
 - New classes: wxActivityIndicator, wxAddRemoveCtrl,
   wxAppProgressIndicator, wxNativeWindow, wxPowerResourceBlocker,
   wxSecretStore.
-- And methods: wxDateTime::GetWeekBasedYear(), wxListBox::GetTopItem(),
+- And methods: wxDataViewToggleRenderer::ShowAsRadio(), wxDateTime::
-  wxProcess::Activate(), wxTextEntry::ForceUpper(), several ones in
+  GetWeekBasedYear(), wxDisplay::GetPPI(), wxGrid::SetCornerLabelValue(),
-  wxRendererNative, wxStandardPaths::GetUserDir(), wxUIActionSimulator
+  wxHtmlEasyPrinting::SetPromptMode(), wxJoystickEvent::GetButtonOrdinal(),
-  ::Select() and many others.
+  wxListBox::GetTopItem(), wxProcess::Activate(), wxTextEntry::ForceUpper(),
-- Significant improvements to: wxBusyInfo, wxNotificationMessage.
+  several ones in wxRendererNative, wxStandardPaths::GetUserDir(),
+  wxToolbook::EnablePage(), wxUIActionSimulator::Select() and many others.
+- Significant improvements to: wxBusyInfo, wxDataViewCtrl,
+  wxNotificationMessage, wxStaticBox, wxStyledTextCtrl.
 - Latest versions of all bundled 3rd party libraries, including all the
   security fixed and support for WebKit 2 and GStreamer 1.7 under Unix.
 - Revamped OpenGL support better suited to modern OpenGL (3.2+).
 - Further C++11 support improvements.
-- New CMake-based alternative build system.
-- Support for latest compilers: MSVS 2017, g++ 7, clang 6.
 - A lot of bug fixes, especially in wxGTK3 and wxOSX/Cocoa ports.
 - New experimental wxQt port.
 
@@ -42,8 +47,8 @@ This release is a "development" one as it makes (very few)
 incompatible API changes compared to 3.0 and does not guarantee the
 ABI stability, unlike the 3.0.x series. It is not inherently more
 buggy or less stable than the "stable" releases and you're encouraged
-to use it. If you're already using 3.0, upgrading shouldn't require
+to use it, including in production. If you're already using 3.0, upgrading
-any special effort, so please try it out.
+shouldn't require any special effort, so please try it out.
 
 We hope that you will enjoy using the new release!
 

docs/readme.txt

@@ -24,53 +24,52 @@ download from:
 * https://github.com/wxWidgets/wxWidgets/releases/tag/v3.1.2/
 
 
-Changes since 3.1.0
+Changes since 3.1.1
 -------------------
 
-There have been more than 2800 commits from more than 160 contributors (79 with
+There have been more than 1200 commits from 75 contributors (41 with multiple
-multiple contributions) since 3.1.0 release. New features added since then
+contributions) since 3.1.1 release. This release primarily contains bug fixes
-include:
+(closing more than 100 bugs from wxTrac) and incremental improvements in
+preparation for the next stable 3.2.0 release, however there is a usual lot of
+new features as well, including:
 
-- Support for gesture events has been added (GSoC 2017 project).
+- Initial support for macOS 10.14 and its dark mode.
-- wxWebView can now return JavaScript results to the C++ code (GSoC 2017).
+- Support for non-integer font sizes and arbitrary font weights.
-- New wxSecretStore class for securely storing user passwords.
+- New wxLZMA{Input,Output}Stream classes.
+- Add wxDataViewToggleRenderer::ShowAsRadio(), wxDisplay::GetPPI(),
+  wxGrid::SetCornerLabelValue(), wxHtmlEasyPrinting::SetPromptMode(),
+  wxJoystickEvent::GetButtonOrdinal(), wxToolbook::EnablePage().
 
 Some of the other improvements:
 
-- wxWidgets can now be built with CMake too.
+- There were again many improvements to the (still experimental) wxQt port.
-- Strings can now be translated differently depending on their context.
+- Fix several bugs related to focus handling and TAB navigation in wxGTK.
-- Converting between wxString and UTF-8 encoded std::string is now
+- Make it possible to control pagination in wxHTML more precisely.
-  simpler and unsafe wxString can now be disabled on the opt-in basis
+- Fix several problems with high-DPI displays.
-  (see http://wxwidgets.blogspot.com/2017/02/safer-s.html)
+- wxOSX now uses native NSImage/UIImage representation for wxBitmap.
-- It is possible to use any window (e.g. wxCheckBox) as wxStaticBox label now.
+- Support strike-through font attribute in XRC and wxDataViewCtrl markup too.
-- Many improvements to accessibility support under MSW.
+- Support more than 4 buttons in wxJoystick.
-- wxGraphicsContext now supports pens with fractional widths.
+- Add wxwidgets.props property sheet file for MSVS users.
-- Support for XDG file layout under Unix.
-- Many bug fixes to the behaviour (including TAB navigation) and appearances,
-  especially in wxGTK3 and wxOSX ports.
-- wxDataViewCtrl items and headers can be formatted using simple markup
-  and it is simpler to combine to put items with checkboxes into it. Many bugs
-  and inconsistencies between platforms in this control have been fixed too.
-- Several enhancements to wxStyledTextCtrl including better support for
-  custom lexers and auto-completion.
-- Many improvements to the (still experimental) wxQt port.
-
-Additionally, the latest versions of compilers (e.g. MSVS 2017) and
-operating systems (macOS 10.12) are now supported and all the third
-party libraries have been updated to their latest versions.
 
 Please refer to the detailed change log for the full list of changes:
 
 https://raw.githubusercontent.com/wxWidgets/wxWidgets/v3.1.2/docs/changes.txt
 
 
+Notice that this release is almost completely compatible with 3.1.1 at the API
+level, so upgrading to it if you're already using wxWidgets 3 should be
+straightforward.
+
+
 Changes since 3.0
 -----------------
 
 Compared to the stable 3.0.x series, this version brings too many
-improvements and even more bug fixes to list them them all. Here is the
+improvements and even more bug fixes to list them all, but here is the
 maximally condensed summary:
 
+- Build system improvements: support for new compilers (MSVS 2017, g++ 8) and
+  OS versions as well as an entirely new new CMake build system.
 - New features: support for mouse gesture events (GSoC 2017 project);
   fractional pen widths in wxGraphicsContext; arbitrary label windows in
   wxStaticBox; markup in wxDataViewCtrl items text; better support for high DPI
@@ -83,13 +82,12 @@ maximally condensed summary:
   wxProcess::Activate(), wxTextEntry::ForceUpper(), several ones in
   wxRendererNative, wxStandardPaths::GetUserDir(), wxUIActionSimulator
   ::Select() and many others.
-- Significant improvements to: wxBusyInfo, wxNotificationMessage.
+- Significant improvements to: wxBusyInfo, wxDataViewCtrl,
+  wxNotificationMessage, wxStaticBox, wxStyledTextCtrl.
 - Latest versions of all bundled 3rd party libraries, including all the
   security fixed and support for WebKit 2 and GStreamer 1.7 under Unix.
 - Revamped OpenGL support better suited to modern OpenGL (3.2+).
 - Further C++11 support improvements.
-- New CMake-based alternative build system.
-- Support for latest compilers: MSVS 2017, g++ 7, clang 6.
 - A lot of bug fixes, especially in wxGTK3 and wxOSX/Cocoa ports.
 - New experimental wxQt port.
 
@@ -98,7 +96,7 @@ maximally condensed summary:
 Platforms Supported
 -------------------
 
-wxWidgets currently supports the following primary platforms:
+This version of wxWidgets supports the following primary platforms:
 
 * Windows XP, Vista, 7, 8 and 10 (32/64 bits).
 * Most Unix variants using the GTK+ toolkit (version 2.6 or newer)
@@ -200,7 +198,7 @@ problems so this ensures that your report will be addressed sooner.
 Further Information
 -------------------
 
-If you are looking for support, you can get it from
+If you are looking for community support, you can get it from
 
 * Mailing Lists: https://www.wxwidgets.org/support/mailing-lists/
 * Discussion Forums: https://forums.wxwidgets.org/
@@ -208,6 +206,13 @@ If you are looking for support, you can get it from
 * Stack Overflow (tag your questions with "wxwidgets"):
   https://stackoverflow.com/questions/tagged/wxwidgets
 
+Commercial support is also available, please see
+https://www.wxwidgets.org/support/commercial/
+
+Finally, keep in mind that wxWidgets is an open source project collaboratively
+developed by its users and your contributions to it are always welcome!
+
+
 Have fun!
 
-The wxWidgets Team, February 2018
+The wxWidgets Team, December 2018