release-notes r1060 - in branches/gnome-2-24: . help/C

[davyd svn gnome org]

Author: davyd
Date: Mon Sep  8 13:27:55 2008
New Revision: 1060
URL: http://svn.gnome.org/viewvc/release-notes?rev=1060&view=rev

Log:
2008-09-08  Davyd Madeley  <davyd fugro-fsi com au>

        * help/C/rndevelopers.xml:
        - most of what's new for devels


Modified:
   branches/gnome-2-24/ChangeLog
   branches/gnome-2-24/help/C/rndevelopers.xml

Modified: branches/gnome-2-24/help/C/rndevelopers.xml
==============================================================================
--- branches/gnome-2-24/help/C/rndevelopers.xml	(original)
+++ branches/gnome-2-24/help/C/rndevelopers.xml	Mon Sep  8 13:27:55 2008
@@ -3,10 +3,128 @@
   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"; [
 <!ENTITY urlfiguresbase "figures/">
 <!ENTITY gnomeversion "2.24">
+<!ENTITY glibversion "2.18">
+<!ENTITY gtkversion "2.14">
 ]>
 
 <sect1 id="rndevelopers">
 	<title>What's New For Developers</title>
 
+	<para>
+		The following changes are important for developers using the GNOME
+		&gnomeversion; developer platform.
+	</para>
+
+	<sect2 id="rndevelopers.glib">
+		<title>GLib &glibversion;</title>
+
+		<para>
+			GLib &glibversion;
+			requires that only top-level headers (e.g. <filename>glib.h</filename>,
+			<filename>gobject.h</filename>, <filename>gio.h</filename>) are included
+			in applications. <!-- FIXME: why are we making this change? -->
+		</para>
+		<tip id="rndevelopers.glib.compat">
+			<title>Compatibility With Existing Codebases</title>
+			<para>
+				There are some existing codebases that will no longer compile because
+				they include non-toplevel headers. This new mode can be overriden by
+				defining <emphasis>G_DISABLE_SINGLE_INCLUDES</emphasis>
+				for GLib and <emphasis>GTK_DISABLE_SINGLE_INCLUDES</emphasis> for GTK+
+				(e.g. as a CFLAG).
+			</para>
+			<para>
+				For example, to compile a program that would otherwise be broken:
+			</para>
+			<informalexample>
+				<programlisting>
+CFLAGS="-DG_DISABLE_SINGLE_INCLUDES -DGTK_DISABLE_SINGLE_INCLUDES -O2 -g" ./configure --prefix=...</programlisting>
+			</informalexample>
+		</tip>
+
+		<para>
+			GLib &glibversion; also features better support for providing context
+			in string translations with C_() and NC_() macros.
+			<!-- FIXME, write more -->
+		</para>
+
+		<para>
+			A complete list of new symbols is available for
+			<ulink
+			url="http://library.gnome.org/devel/glib/stable/ix11.html";>GLib</ulink>
+			and <ulink
+			url="http://library.gnome.org/devel/gio/stable/ix02.html";>GIO</ulink>.
+		</para>
+	</sect2>
+
+	<sect2 id="rndevelopers.gtk">
+		<title>GTK+ &gtkversion;</title>
+
+		<para>
+			As with GLib &glibversion;, GTK+ &gtkversion; requires that only top-level
+			headers (e.g. <filename>gtk.h</filename>,
+			<filename>gdk-pixbuf.h</filename>) are included in applications. For
+			maintaining compatibility with existing applications, read
+			<xref linkend="rndevelopers.glib.compat"/> above.
+		</para>
+
+		<para>
+			A new class, <ulink
+			url="http://library.gnome.org/devel/gtk/stable/gtk-Filesystem-utilities.html";><classname>GtkMountOperation</classname></ulink>
+			has been provided for passing to
+			<ulink
+			url="http://library.gnome.org/devel/gio/stable/GVolume.html#g-volume-mount";><function>g_volume_mount</function></ulink>.
+			<classname>GtkMountOperation</classname> is a
+			<classname>GMountOperation</classname> that is able to display an
+			authentication dialog to the user if required.
+		</para>
+
+		<para>
+			A portable method for opening files and other URIs using the default
+			application is now available using the function
+			<ulink
+			url="http://library.gnome.org/devel/gtk/2.14/gtk-Filesystem-utilities.html#gtk-show-uri";><function>gtk_show_uri()</function></ulink>, rather than having
+			to depend on libgnome. GDK now provides an implementation of
+			<classname>GAppLaunchContext</classname> for handling graphical
+			applications (including startup notification and focus stealing
+			prevention), <ulink
+			url="http://library.gnome.org/devel/gdk/stable/gdk-Application-launching.html";><classname>GdkAppLaunchContext</classname></ulink>.
+		</para>
+
+		<para>
+			Also new in GTK+ &gtkversion; is a <classname>GFile</classname>-based API
+			for <classname>GtkFileChooser</classname> and the ability for
+			<classname>GtkBuilder</classname> to build fragments of an XML tree.
+		</para>
+
+		<para>
+			A complete list of new symbols is available for
+			<ulink
+			url="http://library.gnome.org/devel/gtk/stable/api-index-2-14.html";>GTK+</ulink>
+			and <ulink
+			url="http://library.gnome.org/devel/gdk/stable/ix09.html";>GDK</ulink>.
+		</para>
+	</sect2>
+
+	<sect2 id="rndevelopers.empathy">
+		<title>Instant Messaging Libraries</title>
+		<para>
+			Along with its new instant messaging client (see
+			<xref linkend="rnusers.empathy"/>), GNOME &gnomeversion;
+			includes the libraries libempathy, libempathy-gtk and telepathy-glib
+			that can be used to integrate instant messaging features into any
+			GNOME application.
+		</para>
+		<itemizedlist>
+			<listitem><ulink
+			url="http://library.gnome.org/devel/libempathy/2.23/";>libempathy</ulink></listitem>
+			<listitem><ulink
+			url="http://library.gnome.org/devel/libempathy-gtk/2.23/";>libempathy-gtk</ulink></listitem>
+			<listitem><ulink
+			url="http://library.gnome.org/devel/telepathy-glib/unstable/";>telepathy-glib</ulink></listitem>
+		</itemizedlist>
+
+	</sect2>
+
 </sect1>
 <!-- vi:set tw=80 ts=2: -->