[release-notes/gnome-3-22] add structured logging to the developers page

[Allan Day <allanday src gnome org>]

commit 2c4b2785607d2a4921886de4f8cc5efc9a6df370
Author: Allan Day <allanpday gmail com>
Date:   Fri Sep 2 17:22:11 2016 +0100

    add structured logging to the developers page

 help/C/developers.page |   21 ++++++++++++++++++++-
 1 files changed, 20 insertions(+), 1 deletions(-)
---
diff --git a/help/C/developers.page b/help/C/developers.page
index 918f898..1f8518a 100644
--- a/help/C/developers.page
+++ b/help/C/developers.page
@@ -126,7 +126,7 @@
     <p>Flatpak is the next generation technology for application distribution
     on Linux. It allows applications to be installed on any distribution, and
     provides a robust security framework which protects you from malicious
-    applications. While Flatpak is an independent project, and does not follow
+    applications. While Flatpak is an independent project and does not follow
     the GNOME release cycle, the GNOME project has plans to make it an integral
     part of its application developer experience in the future.</p>
     <p>Since the &lastversion; release, Flatpak has made significant progress.
@@ -139,6 +139,25 @@
     opening files, printing, location services.</p>
   </section>
 
+  <section id="GLib">
+    <title>GLib</title>
+    <media type="image" src="figures/placeholder.png"/>
+    <p>GLib’s logging API has been reworked to support structured key–value log
+    fields. This makes it easier to add logging and makes it possible to write
+    more powerful logging schemes. It also makes it easier to include more
+    metadata in log messages, such as <link
+    href="https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html";>
+    message IDs</link>.</p>
+    <p>As a part of this work, GLib's logging infrastructure has been
+    reorganised around a ‘writer’ function, where an application specifies its
+    logging policy; log handlers are deprecated in favour of this, which
+    reduces ambiguity about how and where logs should be handled, and
+    eliminates conflicts between log handlers.</p>
+    <p>GLib will now automatically pass logging data to systemd-journald,
+    if it is running. stdio-based output works as previously, but with the
+    addition of color!</p>
+  </section>
+
   <section id="more">
     <title>Other Improvements</title>
     <p>Other improvements for developers in GNOME &gnomeversion; include:</p>