[release-notes/gnome-3-16] work up the developers page some more

From: Allan Day <allanday src gnome org>

To: commits-list gnome org

Cc:

Subject: [release-notes/gnome-3-16] work up the developers page some more

Date: Fri, 13 Mar 2015 00:19:56 +0000 (UTC)

commit 945510f53d1ee866757bd01ef1aa764f45fc50d3
Author: Allan Day <allanpday gmail com>
Date: Fri Mar 13 00:19:39 2015 +0000
work up the developers page some more
help/C/developers.page | 92 +++++++++++++++++++++---------------------------
1 files changed, 40 insertions(+), 52 deletions(-)
---
diff --git a/help/C/developers.page b/help/C/developers.page
index e8c4a3d..b95cc48 100644
--- a/help/C/developers.page
+++ b/help/C/developers.page
@@ -28,69 +28,38 @@
<section id="gtk+">
<title>GTK+</title>
<media type="image" src="figures/placeholder.png"/>
- <p>With &gnomeversion;, <link href="http://en.wikipedia.org/wiki/OpenGL&quot;>OpenGL</link> support has
landed in <app>GTK+</app>. This allows embedding OpenGL in GTK+ applications, using the new
<code>GtkGLArea</code> widget.</p>
- <p>Other improvements in this version of <app>GTK+</app> include:</p>
+ <p>With &gnomeversion;, <link href="http://en.wikipedia.org/wiki/OpenGL&quot;>OpenGL</link> support has
landed in <app>GTK+</app>. This allows OpenGL to draw content in GTK+ applications, using the new
<code>GtkGLArea</code> widget, and means that heavily 3D-based applications and games can be written in
conjunction with <app>GTK+</app>.</p>
+
+ <p>OpenGL support in GTK+ &gnomeversion; provides an effective replacement for the previous
<app>GtkGLArea</app> and <app>GtkGLExt</app> libraries. It is also an important step in the development of
the GTK+ Scene Graph.</p>
+
+ <p>Other changes in this version of <app>GTK+</app> includes:</p>
<list>
- <item><p>Mir backend</p></item>
- <item><p>GtkPopoverMenu: New widget for creating popover menus manually</p></item>
- <item><p>Support for versioned themes</p></item>
- <item><p>Better OS X support for app menus</p></item>
- <item><p>Customizable selection behavior in GtkTextView</p></item>
+ <item><p>A display system backend for <app>Mir</app>.</p></item>
+ <item><p><code>GtkPopoverMenu</code>, a new widget for creating menus contained with
popovers.</p></item>
+ <item><p>Themes can now simultaneously support multiple <app>GTK+</app> versions, by including
version-specific CSS.</p></item>
+ <item><p>Improved support for application menus on <app>OS X</app>.</p></item>
+ <item><p>Customizable selection behavior in <code>GtkTextView</code>.</p></item>
</list>
</section>
<section id="gtk-inspector">
<title>GTK+ Inspector</title>
+ <media type="image" src="figures/placeholder.png"/>
<p><app>GTK+</app>'s live inspector has had lots of improvements for &gnomeversion;. New features
include an interactive JavaScript prompt, memory tracking, and a magnifier for inspecting widgets (this is
particularly useful for theme writers).</p>
<p>Other improvements include increased isolation of the inspector, so that settings changes only affect
the application you are inspecting, and a much improved user interface.</p>
</section>
<section id="glib">
<title>glib</title>
+ <p>The latest <app>GLib</app> release includes a number of new features.</p>
<list>
- <item><p>A useful new debugging feature has been introduced, with GObject instance counting. This can
be accessed with <app>GTK+ Inspector</app>, or through ...</p></item>
- <item><p>An improved network monitor implementation allows you to find out the current network
state.</p></item>
- <item><p>&gnomeversion; introduces <code>GListModel</code>, a GSequence-based object list. This
provides an alternative to <code>GtkTreeModels</code>, when your date is naturally organized in GObjects.
<code>GtkListBox</code> has an API (<code>gtk_list_box_bind_model</code>) to use such models.</p></item>
- <item><p><code>G_DECLARE_TYPE</code> is a new macro which reduces boilerplace when creating GObjects
in C.</p></item>
- <item><p>g_autoptr: Automatic cleanup for local variables (supported on gcc and clang)</p></item>
- <item><p>GSimpleIOStream: Simple wrapper for construcing GIOStreams</p></item>
- </list>
- </section>
-
- <section id="gdk-pixbuf">
- <title>GDK Pixbuf</title>
-
- <p>API changes:</p>
- <list>
- <item><p>Deprecate GdkPixdata</p></item>
- <item><p>Add gdk_pixbuf_get_options() helper to list set options</p></item>
- <item><p>Annotations fixes for various functions</p></item>
- <item><p>Remove incorrect info about area-prepared signal</p></item>
- </list>
-
- <p>Image format support changes:</p>
- <list>
- <item><p>Flag multi-page TIFF files.</p></item>
- <item><p>Fix memory usage for GIF animations, add note about minimum frame length.</p></item>
- <item><p>Return an error for truncated PNG files.</p></item>
- <item><p>Add density (DPI) support for JPEG, PNG and TIFF.</p></item>
- <item><p>Fix reading CMYK JPEG files generated by Photoshop.</p></item>
- <item><p>Allow saving 1-bit mono TIFF files as used in faxes.</p></item>
- <item><p>Simplify loader names.</p></item>
- <item><p>Fix loading GIF files when the first write is short.</p></item>
- <item><p>Add progressive loading to ICNS files.</p></item>
- <item><p>Add support for 256x256 ICO files.</p></item>
- <item><p>Fix reading MS AMCap2 BMP files.</p></item>
- </list>
-
- <p>Other:</p>
- <list>
- <item><p>Honour requested depth in Xlib.</p></item>
- <item><p>Special-case compositing/copying with no scaling.</p></item>
- <item><p>Add relocation support to OSX and Linux.</p></item>
- <item><p>Prefer gdk-pixbuf's loaders to the GDI+ ones on Windows.</p></item>
+ <item><p>GObject instance counting is a new debugging feature, which helps to find reference leaks. To
use this facility, set the <code>GOBJECT_DEBUG=instance-count</code> environment variable, and then use
<code>g_type_get_instance_count()</code> to get the number of live objects of a given type. <app>GTK
Inspector</app> has a UI for this.</p></item>
+ <item><p>By making use of <app>NetworkManager</app>, <app>GLib</app>'s network monitor implementation
has been improved. This can be accessed using the existing <code>GNetworkMonitor</code> interface, to find
out the current network state.</p></item>
+ <item><p>&gnomeversion; introduces <code>GListModel</code>, a GSequence-based object list. This
provides an alternative to <code>GtkTreeModel</code>, when data is naturally organized in GObjects.
<code>GtkListBox</code> has an API (<code>gtk_list_box_bind_model</code>) to use such models.</p></item>
+ <item><p>The new <code>G_DECLARE_TYPE</code> macro reduces the amount boilerplace required when
creating GObjects in C.</p></item>
+ <item><p><code>g_autoptr</code> now provides automatic cleanup for local variables (supported on
<app>GCC</app> and <app>Clang</app>).</p></item>
+ <item><p><code>GSimpleIOStream</code> is a new wrapper which makes it easier to constructe
<code>GIOStreams</code>.</p></item>
</list>
-
</section>
<section id="builder">
@@ -102,14 +71,33 @@
<section id="multiwriter">
<title>MultiWriter</title>
- <p>MultiWriter can be used to write an ISO file to multiple USB devices at once. MultiWriter may be
useful for QA testing, to create a GNOME Live image for a code sprint or to create hundreds of LiveUSB drives
for a trade show.</p>
<media type="image" src="figures/placeholder.png"/>
+ <p>MultiWriter can be used to write an ISO file to multiple USB devices at once. MultiWriter may be
useful for QA testing, to create a GNOME Live image for a code sprint or to create hundreds of LiveUSB drives
for a trade show.</p>
</section>
<section id="more">
<title>Other Improvements in &gnomeversion;</title>
- One tracker binary instead of several tools starting with 'tracker-'
- libsoup - support for WebSockets, both client-side and server-side
+ <list>
+ <item><p><app>GDK Pixbuf</app> has improved support for loading and saving various image formats,
including PNG, JPEG, TIFF, ICO and BMP.</p></item>
+ <item><p><app>Tracker</app>'s utilities have been consolidated into a single <code>tracker</code>
command. This replaces the previous collection of utilities, making it easier and more convenient to work
with <app>Tracker</app> from the command line. <code>tracker --help</code> can be used to list all available
subcommands.</p></item>
+ <item><p><app>libsoup</app>, the HTTP client/server library, now supports <link
href="http://en.wikipedia.org/wiki/WebSocket&quot;>WebSockets</link> - support for WebSockets, both client-side
and server-side.</p></item>
+ </list>
+ </section>
+
+ <section id="future">
+ <title>Looking to the Future</title>
+ <p>GNOME &gnomeversion; includes important changes as a part of long-term initiatives for GNOME
technologies.</p>
+
+ <list>
+ <item><p>Work towards full <app><link href="http://en.wikipedia.org/wiki/Wayland_
+%28display_server_protocol%29">Wayland</link></app> adoption has continued apace in &gnomeversion;. Features
like input configuration, pointer barriers are now <app>Wayland</app> compatible, and input handling has made
major progress through the development of <app>libinput</app>. With these changes, the port to
<app>Wayland</app> is now approaching its final stages.</p></item>
+
+ <item><p>The GNOME community has begun development has begun on an exciting new application deployment
framework during the &gnomeversion; development cycle. This framework, called <app><link
href="https://wiki.gnome.org/Projects/SandboxedApps&quot;>XDG App</link></app>, aims to make it possible for
developers to create applications that can run on multiple distributions, and for those applications to be
sandboxed for additional security, stability, and ease of update.</p></item>
+
+ <item><p>Finally, the arrival of <app>OpenGL</app> support in <app>GTK+</app> marks a major
acheivement on the road to the implementation of the <app>GTK+ Scene Graph</app>, which promises to provide
an advanced animation framework for <app>GTK+</app>.</p></item>
+
+ </list>
+
</section>
</page>