Update release post

Author: GuillaumeGomez

_posts/2019-02-21-new-release.md

@@ -1,12 +1,109 @@
 ---
 layout: post
 author: Guillaume Gomez
-title: Across the line
+title: Across the line!
 categories: [front, crates]
 date: 2019-02-21 15:00:00 +0000
 ---
 
-* Write intro here *
+Hi everyone!
+
+It's time for a new release! Main adds/changes this time are:
+
+ * We added the generation of the `Atk` crate.
+ * We now generate functions taking callback as parameters.
+ * We improved the channels handling in `GLib`.
+ * The whole new `GString` type!
+ * The minimum Rust version supported is now the `1.31`.
+ * Even more bindings generated.
+
+Let's see those in details.
+
+#### Atk
+
+The Atk crate is about accessibility. We thought it was a miss not having it considering how important accessibility is, now it's fixed. You can see more information directly on the `Atk` repository: https://github.com/gtk-rs/atk
+
+#### Callbacks?
+
+To present this, let's use the `foreach` method of `TreeModel`:
+
+The C version looks like this:
+
+```C
+void gtk_tree_model_foreach(
+    GtkTreeModel *model,
+    GtkTreeModelForeachFunc func,
+    gpointer user_data
+);
+```
+
+Nothing fancy here: it takes the object we're running this function upon, a callback and some user data. Now here's the Rust version:
+
+```rust
+fn foreach<P: FnMut(&TreeModel, &TreePath, &TreeIter) -> bool>(
+    &self,
+    func: P,
+);
+```
+
+No more user data since closures can capture their environment, just the object and the callback (aka closure). Makes things a bit simpler and nicer to use.
+
+#### GLib channels
+
+Instead of rewriting something fully in here, I'll just show you what it looks like and recommend you to go read the excellent Sebastian's blog post about it: https://coaxion.net/blog/2019/02/mpsc-channel-api-for-painless-usage-of-threads-with-gtk-in-rust/
+
+```rust
+enum Message {
+    UpdateLabel(String),
+}
+
+[...]
+let label = gtk::Label::new("not finished");
+[...]
+// Create a new sender/receiver pair with default priority
+let (sender, receiver) = glib::MainContext::channel(glib::PRIORITY_DEFAULT);
+
+// Spawn the thread and move the sender in there
+thread::spawn(move || {
+    thread::sleep(time::Duration::from_secs(10));
+
+    // Sending fails if the receiver is closed
+    let _ = sender.send(Message::UpdateLabel(String::from("finished")));
+});
+
+// Attach the receiver to the default main context (None)
+// and on every message update the label accordingly.
+let label_clone = label.clone();
+receiver.attach(None, move |msg| {
+    match msg {
+        Message::UpdateLabel(text) => label_clone.set_text(text.as_str()),
+    }
+
+    // Returning false here would close the receiver
+    // and have senders fail
+    glib::Continue(true)
+});
+```
+
+#### `GString` type?
+
+This type has been created in order to prevent some useless copies to improve performances. For example, if you want to get a button label, you don't ownership over it, you just "get" it. Before the `GString` type, we'd clone the returned string and gave it back to the user. Now, we just hold a temporary reference over it, no more copy!
+
+This is part of our performance focus. More to come in the next release!
+
+#### Minimum Rust version supported
+
+We moved it to `1.31.0` mainly because imports handling is much easier starting this version.
+
+#### Even more bindings generated
+
+Just like usual, with the improvements of our gir crate, we are able to generate more and more parts of all the GNOME libraries we wrote bindings for.
+
+#### Conclusion
+
+That's it for this release! Don't forget to take a look at our brand new [F.A.Q. section](https://gtk-rs.org/docs-src/faq).
+
+And again: thanks **a lot** to all of our contributors! This project lives thanks to their awesome work!
 
 ### Changes
 
@@ -17,19 +114,9 @@ For the interested ones, here is the list of the (major) changes:
  * [Install libmount-dev](https://github.com/gtk-rs/sys/pull/131)
  * [Update versions in Travis/AppVeyor configuration](https://github.com/gtk-rs/sys/pull/130)
  * [Update to GNOME 3.14 versions](https://github.com/gtk-rs/sys/pull/129)
- * [WIP: Regen](https://github.com/gtk-rs/sys/pull/127)
- * [Regen](https://github.com/gtk-rs/sys/pull/125)
- * [Regenerate without special generation of enums with a single member](https://github.com/gtk-rs/sys/pull/122)
- * [Regenerate sys crates with new gir and gir-files](https://github.com/gtk-rs/sys/pull/120)
  * [Include missing headers for ABI checks.](https://github.com/gtk-rs/sys/pull/90)
- * [WIP: Fix name for Cairo.FontType](https://github.com/gtk-rs/sys/pull/117)
- * [1 28](https://github.com/gtk-rs/sys/pull/115)
- * [Regen for fixing tests errors](https://github.com/gtk-rs/sys/pull/114)
  * [Fix generating array of pointers](https://github.com/gtk-rs/sys/pull/113)
- * [Regen with GtkResponseType](https://github.com/gtk-rs/sys/pull/112)
  * [Fix GtkIconSize usage](https://github.com/gtk-rs/sys/pull/111)
- * [Regen check](https://github.com/gtk-rs/sys/pull/107)
- * [Regen](https://github.com/gtk-rs/sys/pull/106)
 
 [glib](https://github.com/gtk-rs/glib):
 
@@ -46,9 +133,7 @@ For the interested ones, here is the list of the (major) changes:
  * [Remove leftover testing usage of features for glib/gobject-sys](https://github.com/gtk-rs/glib/pull/443)
  * [Update to GNOME 3.14 versions](https://github.com/gtk-rs/glib/pull/442)
  * [Add ObjectType trait to prelude](https://github.com/gtk-rs/glib/pull/441)
- * [Regen](https://github.com/gtk-rs/glib/pull/437)
  * [Add support for defining new interfaces and other minor things](https://github.com/gtk-rs/glib/pull/438)
- * [Regen](https://github.com/gtk-rs/glib/pull/429)
  * [Only box data passed to Bytes::from_owned() once](https://github.com/gtk-rs/glib/pull/434)
  * [Update for signals using the concrete closure type instead of double-…](https://github.com/gtk-rs/glib/pull/433)
  * [Add new Object::connect_unsafe(), Object::connect_notify_unsafe() and…](https://github.com/gtk-rs/glib/pull/431)
@@ -57,7 +142,6 @@ For the interested ones, here is the list of the (major) changes:
  * [generate from_glib_borrow implementation for const pointers](https://github.com/gtk-rs/glib/pull/428)
  * [Replace deprecated tempdir crate](https://github.com/gtk-rs/glib/pull/427)
  * [Implement DerefMut for class structs too](https://github.com/gtk-rs/glib/pull/426)
- * [Regen](https://github.com/gtk-rs/glib/pull/424)
  * [Clean up glib_wrapper! macro and IsA<_>, Wrapper traits and their impls](https://github.com/gtk-rs/glib/pull/421)
  * [GString: Avoid copy for From<GString> for String impl](https://github.com/gtk-rs/glib/pull/423)
  * [BoolError: allow owning the message](https://github.com/gtk-rs/glib/pull/419)
@@ -68,9 +152,9 @@ For the interested ones, here is the list of the (major) changes:
  * [Fixes compilation on aarch64](https://github.com/gtk-rs/glib/pull/413)
  * [Don't duplicate property name in subclass::Property type](https://github.com/gtk-rs/glib/pull/412)
  * [gstring: Specify a lifetime for the From<str> impl](https://github.com/gtk-rs/glib/pull/411)
- * [lib: Introduce GString](https://github.com/gtk-rs/glib/pull/389)
- * [variant: Implement Value traits manually](https://github.com/gtk-rs/glib/pull/410)
- * [fix: return correct type for Variant::get_type()](https://github.com/gtk-rs/glib/pull/409)
+ * [Introduce GString](https://github.com/gtk-rs/glib/pull/389)
+ * [Implement Value traits manually](https://github.com/gtk-rs/glib/pull/410)
+ * [return correct type for Variant::get_type()](https://github.com/gtk-rs/glib/pull/409)
  * [Add signal::connect_raw() working on raw c_char pointers for the sign…](https://github.com/gtk-rs/glib/pull/406)
  * [Add subclassing test for registering signals, action signals, emittin…](https://github.com/gtk-rs/glib/pull/404)
  * [Add function to get the implementation from an instance](https://github.com/gtk-rs/glib/pull/403)
@@ -85,7 +169,6 @@ For the interested ones, here is the list of the (major) changes:
  * [Run tests on travis with the subclassing feature](https://github.com/gtk-rs/glib/pull/394)
  * [Migrate subclassing infrastructure to glib-rs](https://github.com/gtk-rs/glib/pull/392)
  * [Fix regen_check](https://github.com/gtk-rs/glib/pull/391)
- * [Regen](https://github.com/gtk-rs/glib/pull/390)
  * [Force 1.28 check](https://github.com/gtk-rs/glib/pull/387)
  * [Add bindings for GOptionArg and GOptionFlags](https://github.com/gtk-rs/glib/pull/385)
  * [Use ptr::add(i) instead of ptr::offset(i as isize)](https://github.com/gtk-rs/glib/pull/384)
@@ -115,20 +198,14 @@ For the interested ones, here is the list of the (major) changes:
  * [Add get_mime_data(), set_mime_data() and supports_mime_type()  to cario surface](https://github.com/gtk-rs/cairo/pull/220)
  * [Add cairo_font_type_t](https://github.com/gtk-rs/cairo/pull/219)
  * [Enum rework](https://github.com/gtk-rs/cairo/pull/217)
- * [ add get/set_document_unit() to svg surface ](https://github.com/gtk-rs/cairo/pull/215)
+ * [add get/set_document_unit() to svg surface ](https://github.com/gtk-rs/cairo/pull/215)
  * [Add check for 1.28](https://github.com/gtk-rs/cairo/pull/213)
  * [Better support for PDF, SVG and PostScript.](https://github.com/gtk-rs/cairo/pull/165)
  * [Remove python unlinking in travis config](https://github.com/gtk-rs/cairo/pull/211)
 
 [sourceview](https://github.com/gtk-rs/sourceview):
 
- * [Regen](https://github.com/gtk-rs/sourceview/pull/79)
- * [Regen](https://github.com/gtk-rs/sourceview/pull/78)
- * [Regen with sys and fix futures](https://github.com/gtk-rs/sourceview/pull/77)
- * [Regen](https://github.com/gtk-rs/sourceview/pull/76)
- * [Regen](https://github.com/gtk-rs/sourceview/pull/75)
  * [Add check for 1.28](https://github.com/gtk-rs/sourceview/pull/74)
- * [Regen](https://github.com/gtk-rs/sourceview/pull/73)
  * [Remove connect_xxx_notify for ConstructOnly properties](https://github.com/gtk-rs/sourceview/pull/72)
  * [Improve cargo file a bit](https://github.com/gtk-rs/sourceview/pull/71)
  * [Fragile](https://github.com/gtk-rs/sourceview/pull/67)
@@ -139,12 +216,6 @@ For the interested ones, here is the list of the (major) changes:
  * [Bring Travis and AppVeyor configurations in sync with the GLib one](https://github.com/gtk-rs/atk/pull/18)
  * [Update to GNOME 3.14 versions](https://github.com/gtk-rs/atk/pull/17)
  * [Update rustc version](https://github.com/gtk-rs/atk/pull/16)
- * [Final regen](https://github.com/gtk-rs/atk/pull/15)
- * [WIP: Regen](https://github.com/gtk-rs/atk/pull/14)
- * [Regen](https://github.com/gtk-rs/atk/pull/13)
- * [Regen](https://github.com/gtk-rs/atk/pull/12)
- * [Regen for GString support](https://github.com/gtk-rs/atk/pull/10)
- * [Regen](https://github.com/gtk-rs/atk/pull/9)
  * [improve travis checkup a bit](https://github.com/gtk-rs/atk/pull/8)
  * [Fix for 1.28](https://github.com/gtk-rs/atk/pull/7)
  * [Split into crate branch](https://github.com/gtk-rs/atk/pull/5)
@@ -159,20 +230,13 @@ For the interested ones, here is the list of the (major) changes:
  * [Check if any LGPL docs sneaked in](https://github.com/gtk-rs/gio/pull/193)
  * [Bring Travis and AppVeyor configurations in sync with the GLib one](https://github.com/gtk-rs/gio/pull/192)
  * [Update to GNOME 3.14 versions](https://github.com/gtk-rs/gio/pull/191)
- * [Regen](https://github.com/gtk-rs/gio/pull/190)
- * [Regen](https://github.com/gtk-rs/gio/pull/189)
  * [Define manual traits](https://github.com/gtk-rs/gio/pull/184)
  * [Enable InetAddress{Mask}::equal() and to_string()](https://github.com/gtk-rs/gio/pull/188)
- * [Regen](https://github.com/gtk-rs/gio/pull/187)
  * [Don't box callbacks and other generic parameters twice in async funct…](https://github.com/gtk-rs/gio/pull/186)
- * [Regen](https://github.com/gtk-rs/gio/pull/182)
- * [Regen](https://github.com/gtk-rs/gio/pull/180)
- * [Regen](https://github.com/gtk-rs/gio/pull/179)
  * [Gstring support](https://github.com/gtk-rs/gio/pull/177)
  * [Fix socket.rs build with --features dox](https://github.com/gtk-rs/gio/pull/178)
  * [Mark functions to create a socket from raw fd/socket as unsafe](https://github.com/gtk-rs/gio/pull/175)
  * [Add impls for new std::io::{Read,Write} structs](https://github.com/gtk-rs/gio/pull/172)
- * [Regen](https://github.com/gtk-rs/gio/pull/171)
  * [Add check for 1.28](https://github.com/gtk-rs/gio/pull/170)
  * [Add std::io::{Read,Write} wrappers](https://github.com/gtk-rs/gio/pull/162)
  * [Regen](https://github.com/gtk-rs/gio/pull/168)
@@ -185,12 +249,7 @@ For the interested ones, here is the list of the (major) changes:
  * [Install libmount-dev](https://github.com/gtk-rs/pango/pull/138)
  * [Bring Travis and AppVeyor configurations in sync with the GLib one](https://github.com/gtk-rs/pango/pull/137)
  * [Update to GNOME 3.14 versions](https://github.com/gtk-rs/pango/pull/135)
- * [Final regen](https://github.com/gtk-rs/pango/pull/134)
- * [WIP: Regen](https://github.com/gtk-rs/pango/pull/133)
- * [Regen](https://github.com/gtk-rs/pango/pull/132)
- * [Regen](https://github.com/gtk-rs/pango/pull/131)
  * [Gstring support](https://github.com/gtk-rs/pango/pull/130)
- * [Regen](https://github.com/gtk-rs/pango/pull/129)
  * [Add check for 1.28](https://github.com/gtk-rs/pango/pull/128)
  * [Remove python unlinking in travis config](https://github.com/gtk-rs/pango/pull/127)
 
@@ -199,20 +258,12 @@ For the interested ones, here is the list of the (major) changes:
  * [Install libmount-dev](https://github.com/gtk-rs/gdk-pixbuf/pull/111)
  * [Run regen check when building for 3.14](https://github.com/gtk-rs/gdk-pixbuf/pull/110)
  * [Bring Travis and AppVeyor configurations in sync with the GLib one](https://github.com/gtk-rs/gdk-pixbuf/pull/109)
- * [Fix-up gir/gir-files submodules](https://github.com/gtk-rs/gdk-pixbuf/pull/108)
  * [Update to GNOME 3.14 versions](https://github.com/gtk-rs/gdk-pixbuf/pull/107)
- * [Final regen](https://github.com/gtk-rs/gdk-pixbuf/pull/106)
- * [WIP: Regen](https://github.com/gtk-rs/gdk-pixbuf/pull/105)
- * [Regen](https://github.com/gtk-rs/gdk-pixbuf/pull/104)
  * [Fix CI](https://github.com/gtk-rs/gdk-pixbuf/pull/103)
- * [Regen](https://github.com/gtk-rs/gdk-pixbuf/pull/102)
  * [Don't box closures in async functions twice](https://github.com/gtk-rs/gdk-pixbuf/pull/101)
- * [Regen](https://github.com/gtk-rs/gdk-pixbuf/pull/100)
- * [Regen](https://github.com/gtk-rs/gdk-pixbuf/pull/99)
  * [GdkPixbuf::new return Option](https://github.com/gtk-rs/gdk-pixbuf/pull/97)
  * [Change PixBuf::from_vec() to PixBuf::from_mut_slice() and allow any A…](https://github.com/gtk-rs/gdk-pixbuf/pull/98)
  * [GString support](https://github.com/gtk-rs/gdk-pixbuf/pull/95)
- * [Regen](https://github.com/gtk-rs/gdk-pixbuf/pull/94)
  * [Add check for 1.28](https://github.com/gtk-rs/gdk-pixbuf/pull/93)
  * [Remove python unlinking in travis config](https://github.com/gtk-rs/gdk-pixbuf/pull/92)
  * [Remove wrong connect_xxx_notify](https://github.com/gtk-rs/gdk-pixbuf/pull/91)
@@ -225,21 +276,13 @@ For the interested ones, here is the list of the (major) changes:
  * [Remove useless gio feature dependencies from Cargo.toml](https://github.com/gtk-rs/gdk/pull/275)
  * [Update to GNOME 3.14 versions](https://github.com/gtk-rs/gdk/pull/274)
  * [Update rust version](https://github.com/gtk-rs/gdk/pull/273)
- * [Regen](https://github.com/gtk-rs/gdk/pull/272)
- * [WIP: Regen](https://github.com/gtk-rs/gdk/pull/271)
- * [Regen](https://github.com/gtk-rs/gdk/pull/270)
  * [Define manual traits](https://github.com/gtk-rs/gdk/pull/265)
- * [Regen](https://github.com/gtk-rs/gdk/pull/267)
  * [Don't box closures twice](https://github.com/gtk-rs/gdk/pull/266)
- * [Regen](https://github.com/gtk-rs/gdk/pull/264)
  * [Replace atom borrow](https://github.com/gtk-rs/gdk/pull/263)
- * [Regen](https://github.com/gtk-rs/gdk/pull/262)
  * [Add missing FromGlibBorrow implementation](https://github.com/gtk-rs/gdk/pull/261)
- * [Regen](https://github.com/gtk-rs/gdk/pull/260)
  * [Support const array of gdk::Atom](https://github.com/gtk-rs/gdk/pull/259)
  * [GString support](https://github.com/gtk-rs/gdk/pull/257)
  * [Fix missing cairo conversion](https://github.com/gtk-rs/gdk/pull/255)
- * [Regen](https://github.com/gtk-rs/gdk/pull/254)
  * [Add check for 1.28](https://github.com/gtk-rs/gdk/pull/253)
  * [FrameTimings: use an `Option` when returning refresh_interval](https://github.com/gtk-rs/gdk/pull/252)
  * [FrameTimings: use an `Option` when returning presentation time](https://github.com/gtk-rs/gdk/pull/251)
@@ -256,29 +299,21 @@ For the interested ones, here is the list of the (major) changes:
  * [Acquire the default MainContext when initializing GTK](https://github.com/gtk-rs/gtk/pull/780)
  * [Update to GNOME 3.14 versions](https://github.com/gtk-rs/gtk/pull/778)
  * [Tree model sort](https://github.com/gtk-rs/gtk/pull/777)
- * [Final regen](https://github.com/gtk-rs/gtk/pull/775)
- * [WIP: Regen](https://github.com/gtk-rs/gtk/pull/774)
  * [Define manual traits](https://github.com/gtk-rs/gtk/pull/766)
  * [Support non-GNU versions of make](https://github.com/gtk-rs/gtk/pull/771)
  * [Remove ListBoxExtManual and autogenerate all remaining functions from it](https://github.com/gtk-rs/gtk/pull/770)
  * [Don't box signal callbacks twice](https://github.com/gtk-rs/gtk/pull/767)
  * [Fix CI](https://github.com/gtk-rs/gtk/pull/769)
- * [Regen](https://github.com/gtk-rs/gtk/pull/760)
  * [use &self for SelectionData::set(), fix #747](https://github.com/gtk-rs/gtk/pull/748)
  * [Rename SelectionData get_data_with_length method to get_data](https://github.com/gtk-rs/gtk/pull/762)
- * [Regen](https://github.com/gtk-rs/gtk/pull/759)
  * [Add pango-sys](https://github.com/gtk-rs/gtk/pull/758)
- * [Regen with fix futures](https://github.com/gtk-rs/gtk/pull/757)
- * [Regen](https://github.com/gtk-rs/gtk/pull/756)
  * [GString support](https://github.com/gtk-rs/gtk/pull/745)
  * [Ignore some more problematic functions](https://github.com/gtk-rs/gtk/pull/752)
  * [Update BoolError constructions](https://github.com/gtk-rs/gtk/pull/751)
  * [Generate ComboBox::set_active by hand](https://github.com/gtk-rs/gtk/pull/750)
- * [Regen](https://github.com/gtk-rs/gtk/pull/742)
  * [Add check for 1.28](https://github.com/gtk-rs/gtk/pull/741)
  * [Rename socket trait](https://github.com/gtk-rs/gtk/pull/739)
- * [Atk](https://github.com/gtk-rs/gtk/pull/740)
- * [Regen](https://github.com/gtk-rs/gtk/pull/735)
+ * [Add Atk](https://github.com/gtk-rs/gtk/pull/740)
  * [Into](https://github.com/gtk-rs/gtk/pull/734)
  * [Update doc example](https://github.com/gtk-rs/gtk/pull/731)
  * [Fix response type](https://github.com/gtk-rs/gtk/pull/728)
@@ -299,13 +334,7 @@ For the interested ones, here is the list of the (major) changes:
  * [Bring Travis and AppVeyor configurations in sync with the GLib one](https://github.com/gtk-rs/pangocairo/pull/39)
  * [Update to GNOME 3.14 versions](https://github.com/gtk-rs/pangocairo/pull/38)
  * [Update rust version](https://github.com/gtk-rs/pangocairo/pull/37)
- * [Final regen](https://github.com/gtk-rs/pangocairo/pull/36)
- * [WIP: Regen](https://github.com/gtk-rs/pangocairo/pull/35)
- * [Regen](https://github.com/gtk-rs/pangocairo/pull/34)
- * [Regen](https://github.com/gtk-rs/pangocairo/pull/33)
  * [Fix usage of Cairo.FontType](https://github.com/gtk-rs/pangocairo/pull/32)
- * [Regen](https://github.com/gtk-rs/pangocairo/pull/31)
- * [Regen](https://github.com/gtk-rs/pangocairo/pull/30)
  * [Add check for 1.28](https://github.com/gtk-rs/pangocairo/pull/29)
  * [Remove python unlinking in travis config](https://github.com/gtk-rs/pangocairo/pull/28)