[release-notes/gnome-2-30] add dev updates and installation

[Paul Cutler <pcutler src gnome org>]

commit 76ef8a1ff04e1fcdd932a3d357a208b4b91489d7
Author: Paul Cutler <pcutler gnome org>
Date:   Sat Mar 13 21:56:23 2010 -0600

    add dev updates and installation

 help/C/rndevelopers.xml   |  174 +++++++++++++++++++++++++++++++++++++++++++++
 help/C/rninstallation.xml |   42 +++++++++++
 2 files changed, 216 insertions(+), 0 deletions(-)
---
diff --git a/help/C/rndevelopers.xml b/help/C/rndevelopers.xml
new file mode 100644
index 0000000..72d285f
--- /dev/null
+++ b/help/C/rndevelopers.xml
@@ -0,0 +1,174 @@
+<?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.30">
+<!ENTITY glibversion "2.22">
+<!ENTITY gtkversion "2.18">
+]>
+
+<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 which 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 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 
+			<ulink url="http://www.gnome.org/~fpeters/299.html";>here</ulink>.
+		</para>
+	</warning>
+	
+	<sect2 id="platform.cleanup">
+	<title>Platform Cleanup</title>
+	
+		<para>Large efforts have been undertaken to remove deprecated modules
+		and functionality on the way to GNOME 3.0.
+		</para>
+		
+		<para>FIXME - Andre
+		</para>
+		
+		<para>Other GNOME Platform improvements in GNOME &gnomeversion; include:
+		</para>
+		
+	<itemizedlist>	
+	
+	  <listitem><para>
+		 <application>Evolution</application> and <application>Evolution-Data-Server</application>
+			have completely removed Bonobo in anticipation of GNOME 3.0.  Evolution-Data-Server
+			now uses D-Bus behind the same client-side APIs.
+		</para></listitem>
+	  <listitem><para>
+		 <application>Brasero</application> now has Gobject-introspection support for
+			<classname>libbrasero-media</classname> and <classname>libbrasero-burn.</classname>
+		</para></listitem>
+	  <listitem><para>
+		 The GNOME Magnifier, <application>gnome-mag</application>, supports D-Bus as
+			Bonobo support is deprecated.
+		</para></listitem>
+	  <listitem><para>
+		 <application>devhelp</application> now has a fullscreen mode and will look 
+			for symbols on library.gnome.org when the symbols are not found locally.
+		</para></listitem>
+	  <listitem><para>
+		 <application>glib</application> has added <classname>GConverter<classname>, 
+			a generic interface for streaming data conversion.  
+			Threads are now enabled automatically when g_Type_init() is called.
+		</para></listitem>
+	  <listitem><para>
+		 <application>gnome-keyring</application> has implemented a new "Secret Service"
+			cross desktop password stroage D-Bus API.
+		</para></listitem>
+		
+		</itemizedlist>
+		
+		<para>Many applications have 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.18</title>
+
+	 <para>
+	  GTK+ 2.18 is the latest release of the GTK+ toolkit, which is at the heart
+		of GNOME. GTK+ 2.18 includes new features for developers, as
+		well as extensive bug fixing and housecleaning for the upcoming GTK+ 3.0.
+	 </para>
+	 
+	 <para>GTK+ has also seen a number of other improvements, including:
+	 </para>
+
+	 <itemizedlist>
+	  <listitem><para>
+		 A throbber widget, <classname>GtkSpinner</classname>,  and cell renderer,
+			<classname>GtkCellRendererSpinner</classname> have been added.
+		</para></listitem>
+		<listitem><para>
+		 <interfacename>GtkToolPalette</interfacename> is a new container to show
+			tool items in collapsible groups.
+		</para></listitem>
+	  <listitem><para>
+		 <classname>GtkNotebook</classname> can now have action widgets next to tabs.
+		</para></listitem>
+	
+	 </itemizedlist>
+
+	</sect2>
+
+	<sect2 id="rndevelopers.empathy">
+	 <title>Empathy</title>
+
+	 <para>
+	 <classname>libempathy</classname> and <classname>libempathy-gtk</classname> 
+		have been removed and developers should use <classname>telepathy-glib</classname>
+		instead.
+	 </para>
+
+	<para>
+	 <application>Empathy</application> does not dispatch tube channels any more.  
+		Applications should implement the Client Handler interface to properly interact with
+		<classname>telepathy-mission-control-5</classname>.
+	 </para>
+	 
+	</sect2>
+
+	<sect2 id="rndevelopers.anjuta">
+	 <title>Anjuta</title>
+
+	 <para>
+	 <application>Anjuta</application> features improved code completion, including
+		completion of ".", "->" and "::" in C and C++.
+	 </para>
+
+	<para>
+	 Code completion is now completely asyncronous so it won't disturb you anymore while
+		you are typing.
+	 </para>
+
+	<para>
+	 Anjuta now supports Vala symbols in the symbol manager; full Javascript support including code
+		completion, debugging and building; and basic support for non-automake projects.
+	 </para>
+	 
+	</sect2>
+
+
+</sect1>
+<!-- vi:set tw=80 ts=2: -->
diff --git a/help/C/rninstallation.xml b/help/C/rninstallation.xml
new file mode 100644
index 0000000..135cfb1
--- /dev/null
+++ b/help/C/rninstallation.xml
@@ -0,0 +1,42 @@
+<?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.30">
+]>
+
+<sect1 id="rninstallation">
+	<title>Installing GNOME</title>
+
+	<para>
+		You can try out GNOME &gnomeversion; with GNOME Live Media, which contains all of the software
+		included in GNOME &gnomeversion; in a virtual machine.  Using virtual images, you can try out the latest
+		GNOME in QEMU, KVM, Virtualbox or VMWare.
+    GNOME Live Media can be downloaded from the GNOME
+		<ulink url="http://torrent.gnome.org/";>BitTorrent site</ulink>.
+	</para>
+
+	<para>
+		To install or upgrade your machine to GNOME &gnomeversion;, we recommend you install
+		official packages from your vendor or distribution. Popular distributions
+		will make GNOME &gnomeversion; available very soon, and some already have
+		development versions with GNOME &gnomeversion; available. You can get a list of
+		distributions that ship GNOME and discover the latest versions they ship on our
+		<ulink url="http://www.gnome.org/~davyd/footware.shtml";>Get Footware</ulink>
+		page.
+	</para>
+
+	<para>
+		If you are brave and patient, and would like to build GNOME from source,
+		we recommend you use <ulink
+		url="http://library.gnome.org/devel/jhbuild/";>JHBuild</ulink>, which is
+		designed to build the latest GNOME from Git. You can use JHBuild to build
+		GNOME &gnomeversion;.x by using the <filename>gnome-&gnomeversion;</filename> moduleset.
+	</para>
+
+  <para>
+	  While it is possible to build GNOME directly from the release tarballs, we
+		strongly recommend the use of JHBuild.
+	</para>
+</sect1>
+<!-- vi:set tw=80 ts=2: -->