[release-notes/gnome-2-28] Add new for developers

[Paul Cutler <pcutler src gnome org>]

commit af92b5b89fa3733b7ff9d73207d22b528bac7b6d
Author: Paul Cutler <pcutler gnome org>
Date:   Thu Aug 27 20:14:58 2009 -0500

    Add new for developers

 help/C/rndevelopers.xml |  237 +++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 237 insertions(+), 0 deletions(-)
---
diff --git a/help/C/rndevelopers.xml b/help/C/rndevelopers.xml
new file mode 100644
index 0000000..dc0e498
--- /dev/null
+++ b/help/C/rndevelopers.xml
@@ -0,0 +1,237 @@
+<?xml version="1.0"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
+  "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"; [
+<!ENTITY urlfiguresbase "figures/">
+<!ENTITY gnomeversion "2.28">
+<!ENTITY glibversion "2.18">
+<!ENTITY gtkversion "2.16">
+]>
+
+<sect1 id="rndevelopers">
+	<title>What's New For Developers</title>
+
+	<para>
+		The following changes are important for developers using the GNOME
+		&gnomeversion; developer platform. If you're not interested in
+		changes for developers, you can skip
+		forward to <xref linkend="rni18"/>.
+	</para>
+
+	<para>
+	 As well as the GNOME Desktop, GNOME &gnomeversion; is the latest release
+	 of the GNOME Developer Platform, a set of API and ABI stable libraries
+	 available under the GNU LGPL that can be used for the development of
+	 cross-platform applications.
+	</para>
+
+	<warning id="rndevelopers.deprecated">
+		<title>Fixing Usage of Deprecated Libraries</title>
+
+		<para>
+			Starting with GNOME 3.0, various deprecated parts of GNOME will be
+			removed. These deprecated components include  GNOME-specific libraries
+			such as libart_lgpl, libbonobo, libbonoboui, libglade, libgnome, 
+			libgnomecanvas libgnomeprint, libgnomeprintui, libgnomeui, and libgnomevfs. 
+			For applications that ship as part of the GNOME Desktop,
+                        a number of
+			<ulink url="http://live.gnome.org/GnomeGoals";>cleanup tasks</ulink>
+			have been carried out to ensure no deprecated code is used.
+			This will ensure the smooth transition to GNOME 3.0.
+		</para>
+
+		<para>
+			Developers are strongly urged to follow this example in their own
+			applications too.
+			Furthermore, for any developers (or potential developers) who wish to
+			help us out, the
+			<ulink url="http://live.gnome.org/GnomeGoals";>GNOME goals</ulink>
+			wiki page lists the various tasks that are yet to be completed.
+			An automatically created and updated status overview of remaining work 
+			for modules that are supported by the jhbuild build tool can be found 
+			<a href="http://www.gnome.org/~fpeters/299.html";>here</a>.
+		</para>
+	</warning>
+	
+	<sect2 id="platform.cleanup">
+	
+		<para>Large efforts have been undertaken towards removing deprecated modules
+		and functionality on the way to GNOME 3.0.
+		</para>
+		
+		<para>In GNOME 2.28, there are no applications that depend on esound, libgnomevfs,
+		libgnomeprint, or libgnomepritnui.
+		</para>
+		
+		<para>Other GNOME Platform improvements in GNOME 2.28 include:
+		</para>
+	
+	  <listitem><para>
+		 A dependency on libart_lgpl was removed from 2 modules (eog, gtkhtml);
+		</para></listitem>
+	  <listitem><para>
+		 A dependency on libbonobo(ui) was removed from 5 modules 
+		 (gnome-control-center, gcalctool, gnome-media, gtkhtml, accerciser);
+		</para></listitem>
+	  <listitem><para>
+		 A dependency on libglade was removed from 28 modules 
+		 (accerciser, alacarte, gnome-control-center, dasher, empathy, 
+		 gcalctool, gnome-games, gnome-netstatus, gnome-nettool, gnome-mag, 
+		 gnome-menus, gnome-panel, gnome-power-manager, gnome-screensaver, 
+		 gnome-session, gnome-settings-daemon, gnome-system-tools, gnome-utils, 
+		 gtkhtml, hamster-applet, libgnomekbd, orca, pessulus, seahorse, vino, 
+		 vinagre, yelp, zenity);
+		</para></listitem>
+	  <listitem><para>
+		 A dependency on libgnome was removed from 14 modules 
+		 (anjuta, gnome-control-center, dasher, evolution-webcal, gconf, 
+		 gdl, gdm, gnome-desktop, gnome-media, gnome-system-tools, gok, 
+		 gtkhtml, vino, yelp);
+		</para></listitem>
+	  <listitem><para>
+		 A dependency on libgnomecanvas was removed from 3 modules 
+		 (anjuta, gtkhtml, zenity),;
+		</para></listitem>
+	  <listitem><para>
+		 A dependency on libgnomeprint(ui) was removed from 1 module (gnome-games);
+		</para></listitem>
+	  <listitem><para>
+		 A dependency on libgnomeui was removed from 16 modules 
+		 (anjuta, gnome-control-center, dasher, deskbar-applet, gnome-mag, 
+		 gnome-media, gnome-settings-daemon, gnome-system-tools, gnome-utils, 
+		 gok, gtkhtml, hamster-applet, nautilus, orca, vino, yelp);
+		</para></listitem>
+	  <listitem><para>
+		 dependency on libgnomevfs was removed from 3 modules 
+		 (dasher, gnome-mag, gnome-utils);
+		</para></listitem>
+	  <listitem><para>
+		 Many modules now provide a nicer and cleaner build output when compiling 
+		 them by using Shave or AM_SILENT_RULES - see 
+		 <a href="http://live.gnome.org/GnomeGoals/NicerBuilds";>
+		 http://live.gnome.org/GnomeGoals/NicerBuilds</a>; and 
+		</para></listitem>
+	  <listitem><para>
+		 Some modules started using GIntrospection - see 
+		 <a href="http://live.gnome.org/GnomeGoals/AddGObjectIntrospectionSupport";>
+		 http://live.gnome.org/GnomeGoals/AddGObjectIntrospectionSupport</a>.
+		</para></listitem>
+		
+		<para>Many application shave also removed the usage of deprecated GTK+
+		and Glib symbols and have applied the new policy to only include
+		top level headers of GTK+ and GLib.
+		</para>
+
+	
+
+	</sect2>
+
+  <sect2 id="rndevelopers.gtk">
+	 <title>GTK+ 2.16</title>
+
+	 <para>
+	  GTK+ 2.16 is the latest release of the GTK+ toolkit, which is at the heart
+		of GNOME. GTK+ 2.16 includes a couple of new features for developers, as
+		well as extensive bug fixing and housecleaning for the upcoming GTK+ 3.0.
+	 </para>
+
+	 <para>
+	  <classname>GtkEntry</classname> The file chooser has better ellipsization in the path bar, 
+	  remembers its sorting state and has better defaults such as  hiding backup files by default, 
+	  and showing the size column by default.
+	 </para>
+	 
+	 <para>GTK+ has also seen a number of other improvemnts, including:</para>
+
+	 <itemizedlist>
+	  <listitem><para>
+		 <classname>GtkEntry</classname> widgets can now also be used to display.
+		a progress bar.
+		</para></listitem>
+		<listitem><para>
+		 <interfacename>GtkEntry</interfacename> has a model-view separation, to allow for secure memory allocation .
+		</para></listitem>
+	  <listitem><para>
+		 <classname>GtkLabel</classname> can show embedded urls.
+		</para></listitem>
+		<listitem><para>
+		 Printing supports printing a 'selection'. 
+		</para></listitem>
+		<listitem><para>
+		 Page setup controls can be embedded in the print dialog 
+		</para></listitem>.
+		<listitem><para>
+		 Statusicons have a title property, for improved accessibility.
+		</para></listitem>
+		<listitem><para>
+		 A new widget, <interfacename>GtkInfoBar</interfacename>, has been
+		added to display messages in the main window instead of in a dialog.
+		</para></listitem>
+	 </itemizedlist>
+
+	</sect2>
+
+	<sect2 id="rndevelopers.brasero">
+	 <title>Access to Disc Burning APIs</title>
+
+	 <para>
+	  <application>libbrasero-media</application> provides an API for accessing
+		the disc burning infrastructure in GNOME. An example of its use can be found
+		in GNOME's Media Player, which includes a plugin to burn DVDs and VCDs from
+		a video.
+	 </para>
+	</sect2>
+
+	<sect2 id="rndevelopers.evince">
+	 <title>Access to Evince APIs</title>
+
+	 <para>
+	  A new library, <application>libevview</application>, has been created to
+		provide the <classname>EvView</classname> widget used in
+		<application>Evince</application>. This allows other applications to embed
+		Evince's document viewing component.
+	 </para>
+
+	 <para>
+	  <application>libevdocument</application> is a library that makes it possible
+		to develop third-party document backends for use with Evince without having
+		to add them to the Evince source tree.
+	 </para>
+
+	 <para>
+	  Both libraries already have available Python bindings included in
+		<application>gnome-python-desktop</application>.
+	 </para>
+	</sect2>
+
+	<sect2 id="rndevelopers.anjuta">
+	<title>Anjuta</title>
+
+	<para>
+		The <application>Anjuta</application> integrated development environment
+		has gained some great improvements in GNOME &gnomeversion;.
+		Most important is a completely rewritten symbol 
+    management engine that, together with the new bookmark system,
+		allows for much faster code navigation.
+		Auto-detection of any libraries using 
+		<application>pkg-config</application> for code completion and calltips is
+		now possible.
+  </para>
+  <para>
+		In addition, the integration of version control systems and the
+		<application>Glade</application> interface designer have taken a major
+		step forward. The file tree now shows status icons for
+		all files in projects using the <application>Subversion</application>
+		or <application>Git</application> version control systems.
+		It is possible to automatically generate callbacks from Glade, and
+		GtkBuilder files are now supported.
+  </para>
+	<para>
+		For better support of the GNOME Mobile platform, remote debugging using 
+		<application>gdbserver</application> and support for
+		<application>Scratchbox</application> (version 2) have also
+		been added.
+	</para>	
+	</sect2>
+
+</sect1>
+<!-- vi:set tw=80 ts=2: -->