[gtkmm] Improved NEWS



commit f49d9da94b863292bbd60c98d6586b46ba8f9497
Author: Murray Cumming <murrayc murrayc com>
Date:   Wed Apr 6 15:48:15 2011 +0200

    Improved NEWS

 NEWS |   58 +++++++++++++++++++++++++++++++++++++++++++++++++++++++---
 1 files changed, 55 insertions(+), 3 deletions(-)
---
diff --git a/NEWS b/NEWS
index 9ad5533..facf10c 100644
--- a/NEWS
+++ b/NEWS
@@ -1,10 +1,62 @@
+gtkmm 3.0:
+
+To port to gtkmm-3.0 you should first try to build your application with
+gtkmm-2.4 but without using deprecated API. For instance:
+http://www.murrayc.com/blog/permalink/2011/01/18/avoiding-use-of-deprecated-api/
+
+The deprecated API generally has documentation suggesting what new API you
+should use instead:
+http://developer.gnome.org/gtkmm/unstable/deprecated.html
+
+These hints might also be helpful:
+http://live.gnome.org/gtkmm/PortingToGtkmm3
+
+Some new/changed API in gtkmm-3.0:
+
+Gtk:
+* Adjustment is now used via RefPtr.
+* AppChooser, AppChooserButton, AppChooserDialog.
+* Box, ButtonBox, IconView, Paned, ProgressBar, ScaleButton, ScrollBar,
+  and Separator now derive from Orientable.
+* All widgets derive from Buildable.
+* Several widgets derive from Scrollable.
+* CellArea and CellAreaBox
+* ComboBox now derives from CellLayout.
+* IconSet is now used via RefPtr.
+* StyleContext, StyleProvider, and CssProvider, replacing Style and Rc.
+* Grid
+* NumerableIcon.
+* Switch
+* Widget::on_expose_event() is now Widget::on_draw().
+
+Gdk:
+* Added DeviceManager.
+* Removed Drawable, Pixmap and Bitmap.
+* Cursor is now used via RefPtr.
+* RGBA replaces Color, though Color still exists because it is used by TextView.
+  We hope to deprecated Color completely in gtkmm 3.2.
+* Removed Colormap and its general awkardness.
+
+General:
+* Use std::vector in several methods instead of the intermediate *Handle types,
+  to make the API clearer.
+* Change all operator void* to operator const void*, with a BoolExpr typedef
+  and extra documentation.
+  This avoids an unintentional implicit cast to int, and is generally
+  considered good practice in C++. The new C++ standard allows the use of
+  the explicit keyword here instead, but that is not yet widespread.
+* Many existing classes have many new methods.
+* gtkmm-3.0 currently has no deprecated API.
+  Note even API that was added and then deprecated during GTK+ 3.0.
+
+
 3.0.0 (unstable):
 
 Gtk:
-* Change all operator void* to operator const void*, with a BoolExpr typedef 
+* Change all operator void* to operator const void*, with a BoolExpr typedef
   and extra documentation.
-  This avoids an unintentional implicit cast to int, and is generally 
-  considered good practice in C++. The new C++ standard allows the use of 
+  This avoids an unintentional implicit cast to int, and is generally
+  considered good practice in C++. The new C++ standard allows the use of
   the explicit keyword here instead, but that is not yet widespread.
   (Murray Cumming, Daniel Elstner)
 * NumerableIcon: Really add get_background_gicon() const.



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]