GNOME.org
 

[release-notes/gnome-2-28] Misc corrections to rndevelopers

commit dc382d0949ed38cea0e98bc609eeab344453d06b
Author: Shaun McCance <shaunm gnome org>
Date:   Wed Sep 2 13:37:24 2009 -0500

    Misc corrections to rndevelopers

 help/C/rndevelopers.xml |   98 ++++++++++++++++++++++++-----------------------
 1 files changed, 50 insertions(+), 48 deletions(-)
---
diff --git a/help/C/rndevelopers.xml b/help/C/rndevelopers.xml
index e095ee4..585600b 100644
--- a/help/C/rndevelopers.xml
+++ b/help/C/rndevelopers.xml
@@ -19,8 +19,8 @@
 
 	<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
+	 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>
 
@@ -55,7 +55,7 @@
 	<sect2 id="platform.cleanup">
 	<title>GNOME 2.28 Platform Cleanup</title>
 	
-		<para>Large efforts have been undertaken towards removing deprecated modules
+		<para>Large efforts have been undertaken to remove deprecated modules
 		and functionality on the way to GNOME 3.0.
 		</para>
 		
@@ -69,11 +69,11 @@
 	<itemizedlist>	
 	
 	  <listitem><para>
-		 A dependency on libart_lgpl was removed from 2 modules (eog, gtkhtml);
+		 A dependency on libart_lgpl was removed from two modules (eog and gtkhtml).
 		</para></listitem>
 	  <listitem><para>
-		 A dependency on libbonobo(ui) was removed from 5 modules 
-		 (gnome-control-center, gcalctool, gnome-media, gtkhtml, accerciser);
+		 A dependency on libbonobo(ui) was removed from five modules 
+		 (gnome-control-center, gcalctool, gnome-media, gtkhtml, and accerciser).
 		</para></listitem>
 	  <listitem><para>
 		 A dependency on libglade was removed from 28 modules 
@@ -82,47 +82,47 @@
 		 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 and zenity);
+		 vinagre, yelp, and 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);
+		 gtkhtml, vino, and yelp).
 		</para></listitem>
 	  <listitem><para>
-		 A dependency on libgnomecanvas was removed from 3 modules 
-		 (anjuta, gtkhtml, zenity),;
+		 A dependency on libgnomecanvas was removed from three modules 
+		 (anjuta, gtkhtml, and zenity).
 		</para></listitem>
 	  <listitem><para>
-		 A dependency on libgnomeprint(ui) was removed from 1 module (gnome-games);
+		 A dependency on libgnomeprint(ui) was removed from one 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);
+		 gok, gtkhtml, hamster-applet, nautilus, orca, vino, and yelp).
 		</para></listitem>
 	  <listitem><para>
-		 A dependency on libgnomevfs was removed from 3 modules 
-		 (dasher, gnome-mag, gnome-utils);
+		 A dependency on libgnomevfs was removed from three modules 
+		 (dasher, gnome-mag, and gnome-utils).
 		</para></listitem>
 	  <listitem><para>
 		 Many modules now provide a nicer and cleaner build output when compiling 
 		 them by using AM_SILENT_RULES or Shave.  For more information see 
 		 <ulink url="http://live.gnome.org/GnomeGoals/NicerBuilds";>
-		 http://live.gnome.org/GnomeGoals/NicerBuilds</ulink>; and 
+		 http://live.gnome.org/GnomeGoals/NicerBuilds</ulink>.
 		</para></listitem>
 	  <listitem><para>
-		 Some modules started using GIntrospection - see 
+		 Some modules started using GIntrospection â?? see 
 		 <ulink url="http://live.gnome.org/GnomeGoals/AddGObjectIntrospectionSupport";>http://live.gnome.org/GnomeGoals/AddGObjectIntrospectionSupport</ulink>
-		 for more detail.
+		 for more details.
 		</para></listitem>
 		
 		</itemizedlist>
 		
-		<para>Many application shave also removed the usage of deprecated GTK+
-		and Glib symbols and have applied the new policy to only include
+		<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>	
 
@@ -133,16 +133,18 @@
 
 	 <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
+		of GNOME. GTK+ 2.16 includes new features for developers, as
 		well as extensive bug fixing and housecleaning for the upcoming GTK+ 3.0.
 	 </para>
 
+    The file chooser has better ellipsization in the path bar, 
+
 	 <para>
-	  <classname>GtkEntry</classname> has a number of improvements, including:  
-	  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>
+     The file chooser has a number of improvements.  It now remembers its
+     sorting state and has better defaults, such as hiding backup files
+     and showing the Size column.  It also has improved ellipsization
+     in the path bar.
+   </para>
 	 
 	 <para>GTK+ has also seen a number of other improvements, including:
 	 </para>
@@ -153,20 +155,19 @@
 		 a progress bar.
 		</para></listitem>
 		<listitem><para>
-		 <interfacename>GtkEntry</interfacename> has a model-view separation, 
-		 to allow for secure memory allocation.
+		 <interfacename>GtkEntry</interfacename> has a model-view separation.
 		</para></listitem>
 	  <listitem><para>
-		 <classname>GtkLabel</classname> can show embedded urls.
+		 <classname>GtkLabel</classname> can show embedded URIs.
 		</para></listitem>
 		<listitem><para>
-		 Printing supports printing a 'selection'. 
+		 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.
+		 Status icons have a title property, for improved accessibility.
 		</para></listitem>
 		<listitem><para>
 		 A new widget, <interfacename>GtkInfoBar</interfacename>, has been
@@ -179,40 +180,41 @@
 	<sect2 id="GLib">
 	<title>GLib</title>
 	
-		<para>GNIO has been merged into GIO, and APIs for working with IPv4 and IPv6 
-		addresses, resolving hostnames, reverse IP lookup, low level socket I/O, and working
-		with network connections and services are now included.
+		<para>GNIO has been merged into GIO, and APIs are now included for working
+    with IPv4 and IPv6 addresses, resolving hostnames, reverse IP lookup, low-level
+    socket I/O, and working with network connections and services.
 		</para>
 		
 		<para><classname>GArray</classname>, <classname>GMappedFile</classname>
-		and <classname>GTree</classname> are now refcounted.
+		and <classname>GTree</classname> are now reference counted.
 		</para>
 		
-		<para>The mainloop supports per-thread default contexts.
+		<para>The main loop supports per-thread default contexts.
 		</para>
 		
-		<para>Support for read-write access with <classname>GIOStream</classname>
-		 and its subclasses has been added.
+		<para>Support has been added for read-write access with <classname>GIOStream</classname>
+		 and its subclasses.
 		</para>
 		
-		<para><classname>GLib</classname> now also includes support for per-file metadata.
+		<para>GLib now also includes support for per-file metadata.
 		</para>
 	
 	</sect2>
 
 	<sect2 id="rndevelopers.mallard">
-	 <title>GNOME Documentation Project</title>
+	 <title>GNOME Documentation</title>
 
 	 <para>
-	  Support for the new GNOME Documentation XML language, Mallard, has been
+	  Support for Mallard, the new GNOME Documentation XML language, has been
 	  added to Yelp and gnome-doc-utils.
 	 </para>
 	 
-	 <para>For documentation writers, Mallard is a fully featured XML markup, with 
+	 <para>For documentation writers, Mallard is a full-featured XML markup
+   language designed explicitly for topic-oriented help, with 
 	 an easier learning curve than Docbook.
 	 </para>
 	 
-	 <para>The <application>Empathy</application> documentation is the first GNOME
+	 <para>The <application>Empathy</application> help is the first GNOME 
 	 documentation to be written in Mallard, and is also the first documentation
 	 to move to a Creative Commons Share-Alike 3.0 license, which all GNOME documentation
 	 will be moving to in the future.
@@ -241,18 +243,18 @@
 	  With Epiphany's change to Webkit, a number of enhancements are available for developers in Epiphany.
 	 </para>
 	 
-	 <para>WebKitGTK+ includes extremely fast Javascript processing, a smaller footprint, a GoBject API,
+	 <para>WebKitGTK+ includes extremely fast Javascript processing, a smaller footprint, a GObject API,
 	 and a built-in web inspector.  Epiphany also includes new support for Seed (JavaScript) extensions, and 
 	 with this addition Python support has been removed.  
 	 </para>
 	 
-	 <para>Epiphany also uses <classname>libsoup</classname> for HTTP implementation and proxies now
-	 work the same way across GNOME now.  Missing features in <classname>libsoup</classname> include 
-	 HTTP cache and content-encoding.
+	 <para>Epiphany also uses libsoup for its HTTP implementation, and proxies now
+	 work the same way across GNOME.  Missing features in libsoup include 
+	 HTTP cache and content encoding.
 	 </para>
 	 
 	 <para>Lastly, the context menu in the web view is not customized for Epiphany yet, though the default
-	 Webkit view is used.
+	 WebKit view is used.
 	 </para> 
 
 	</sect2>
@@ -261,7 +263,7 @@
 	 <title>Time Tracker Applet</title>
 
 	 <para>
-	  All functions are now available via a D-Bus API and introspectable via d-feet.
+	  All functions are now available via an introspectable D-Bus API.
 	 </para>
 
 	</sect2>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]