[release-notes/gnome-3-12] start to elaborate the developers page

[Allan Day <allanday src gnome org>]

commit 4f29d0d7a6c0f547358b748e08a5675ff160e6e4
Author: Allan Day <allanpday gmail com>
Date:   Mon Mar 17 17:43:54 2014 +0000

    start to elaborate the developers page

 help/C/developers.page |   44 ++++++++++++++++++++++++++------------------
 1 files changed, 26 insertions(+), 18 deletions(-)
---
diff --git a/help/C/developers.page b/help/C/developers.page
index ccece2a..d077503 100644
--- a/help/C/developers.page
+++ b/help/C/developers.page
@@ -26,23 +26,24 @@
 
   <section id="gtk-widgets">
     <title>New GTK+ Widgets</title>
-    <p>GtkActionBar: A new container, which has a centered child like GtkHeaderBar.</p>
-    <p>GtkPopover: A new widget that is can be used for transient views, as an alternative to menus or 
dialogs.</p>
-    <p>GtkFlowBox: A container that its children in a reflowing grid, which can be oriented horizontally or 
vertically.</p>
+    <p>The GTK+ toolkit has three new interface widgets for 3.12:</p>
+    <list>
+      <item><p>GtkActionBar: A new container, which has a centered child like GtkHeaderBar. This is intended 
for use at the bottom of widgets for presenting actions for selected content.</p></item>
+      <item><p>GtkPopover: A new widget that is can be used for transient views, as an alternative to menus 
or dialogs.</p></item>
+      <item><p>GtkFlowBox: A container that its children in a reflowing grid, which can be oriented 
horizontally or vertically.</p></item>
+    </list>
   </section>
 
   <section id="notifications">
-    <title>New Notifications API</title>
-    <p>GNotification: Notification support in GApplication</p>
-    <p>A new API that adds desktop notification support to GApplication. Allows for notifications to persist 
after an application exits and restart the application when the notification is clicked
-replaces libnotify, but can fall back to the org.freedesktop.Notifications D-Bus interface. More details at: 
https://wiki.gnome.org/HowDoI/GNotification</p>
+    <title>Integrated Notifications API</title>
+    <p>3.12 introduces a new API that adds notification support to GApplication. This replaces the existing 
libnotify API, but can fall back to the org.freedesktop.Notifications D-Bus interface. The new API provides 
many of libnotify's capabilities, plus some new ones, such as the ability for notifications to persist after 
an application exits. It also makes it possible to restart an application when a notification is activated by 
the user.</p>
+    <p>More details on how to use the GNotification API can be found on the <link 
href="https://wiki.gnome.org/HowDoI/GNotification";>How Do I</link> page.</p>
   </section>
 
   <section id="process-launching">
     <title>Powerful New Process Launching API</title>
-    <p>GSubprocess: More powerful process launching API</p>
-    <p>gapplication command line utility can be used for launching apps, opening files, invoking application 
actions and listing apps and actions, with bash completion</p>
-    <p>GApplication supports command line handling, including a convenient --gapplication-service option</p>
+    <p>A new, more powerful process launching API is included in 3.12, called GSubprocess. The new API 
allows the gapplication command line utility to be used for launching applications. Applications can be 
instructed to open files, and application actions can also be triggered. It is also possible to list the 
available applications and actions, and the command line utility comes complete with bash completion</p>
+    <p>GApplication now also supports command line handling, including a convenient --gapplication-service 
option.</p>
   </section>
 
   <section id="docs">
@@ -57,14 +58,17 @@ replaces libnotify, but can fall back to the org.freedesktop.Notifications D-Bus
 
   <section id="tracker">
     <title>Tracker</title>
-    <p>libmediaart: New library created from sources in Tracker to handle art associated with media (like 
audio/video). Not to be confused with thumbnail generation which is usually for personal content (e.g. photos 
taken).</p>
-    <p>New library: for managing miners you can use libtracker-control now.</p>
-    <p>New feature: passive extraction offers specific metadata extraction (e.g. image orientation) by 
listening to signals on resource changes. Previously inserting ANY information about a resource was done in 
one step. This feature means that now file data (e.g. file name, size, etc) is inserted even if specific 
metadata isn't.</p>
-    <p>New feature: prioritization of RDF types is available to enable extraction of certain file types 
before others.</p>
-    <p>New feature: SPARQL functions tracker:normalize() and tracker:unaccent() have been added.</p>
-    <p>New feature: tracker-sparql --tree to describe the database ontology and help understand the class 
hierarchy.</p>
-    <p>New feature: encoding detection for metadata with ICU.</p>
-    <p>New feature: store's GraphUpdated signal delay is now configurable. This signal is what's used to 
notify of resource changes in the database (e.g. new file added). Previously it was always 1 second.</p>
+    <p><app>Tracker</app> the search engine, search tool and metadata storage system, comes with a long list 
of improvements for 3.12:</p>
+    <list>
+      <item><p>A new library called libmediaart has been created from Tracker code to handle art associated 
with multimedia files. libmediaart allows art stored in media files to be cache, and provides a consistent 
way to lookup art and reduce cache sizes for artists, albums and media items. (Note that it is not intended 
to generate thumbnails to be confused with thumbnail generation which is usually for personal content (e.g. 
photos taken).</p></item>
+      <item><p>libtracker-control is another new library for 3.12, which manages search miners.</p></item>
+      <item><p>The new passive extraction features allows specified metadata extraction (e.g. image 
orientation) by listening to signals on resource changes. Previously inserting information about a resource 
was done in one step. This feature means that now file data (e.g. file name, size, etc) is inserted even if 
specific metadata isn't.</p></item>
+      <item><p>It is now possible to prioritize RDF types when indexing: this enables indexing to be tuned 
and depending on the situation.</p></item>
+      <item><p>The tracker:normalize() and tracker:unaccent() SPARQL functions are now supported.</p></item>
+      <item><p>A new command called tracker-sparql --tree will display the database ontology and so help 
developers to get a clear picture of the class hierarchy.</p></item>
+      <item><p>Encoding detection is now supported for metadata with ICU.</p></item>
+      <item><p><app>Tracker</app> store's GraphUpdated signal delay is now configurable. This signal is used 
to provide notifications of resource changes in the database (e.g. new file added). Previously it was always 
1 second.</p></item>
+    </list>
   </section>
 
   <section id="grilo-extensions">
@@ -72,6 +76,9 @@ replaces libnotify, but can fall back to the org.freedesktop.Notifications D-Bus
     <p>The updated Videos application includes a range of online video channels that users can browse, 
search and view. Developers can easily add video channels of their own, with a simple extension  
http://www.hadess.net/2014/02/extend-gnome-videos-with-lua.html</p>
   </section>
 
+Matured Client-Side Decorations
+height problems fixed, drag-by-touch working
+
   <section id="more">
     <title>Other Improvements</title>
     <p>Unicode 6.3.0 support</p>
@@ -79,6 +86,7 @@ replaces libnotify, but can fall back to the org.freedesktop.Notifications D-Bus
     <p>Model-based menus can hide items on various conditions</p>
     <p>GtkBox supports a centered child like GtkHeaderBar</p>
     <p>High DPI density displays are now supported in Clutter, using the same setting shared by GTK+ and the 
GNOME Settings Daemon.</p>
+    <p>GtkHeaderBar - improved compatibility with different environments. </p>
   </section>
 
 </page>