GNOME.org
 

[release-notes/gnome-3-2] Copy edits to rna11y rndevelopers, rninstallation

commit 88cb25dab84c03566f4c5ec5b4a136a41de5b1dd
Author: Shaun McCance <shaunm gnome org>
Date:   Thu Sep 15 16:00:50 2011 -0400

    Copy edits to rna11y rndevelopers, rninstallation

 help/C/rna11y.xml         |    8 ++--
 help/C/rndevelopers.xml   |   73 ++++++++++++++++++++++-----------------------
 help/C/rninstallation.xml |    4 +-
 3 files changed, 42 insertions(+), 43 deletions(-)
---
diff --git a/help/C/rna11y.xml b/help/C/rna11y.xml
index 2fc997f..77bdd19 100644
--- a/help/C/rna11y.xml
+++ b/help/C/rna11y.xml
@@ -15,7 +15,7 @@
       Until GNOME &gnomeversion;, assistive technology users have faced an
       unfortunate dilemma: The option to enable accessibility support is not
       accessible until the accessibility support has been enabled. Until
-      accessibility support can be enabled by default, Assistive Technologies
+      accessibility support can be enabled by default, assistive technologies
       need a single, reliable means to determine if accessibility support is
       enabled, as well as to enable it. Thanks to improvements in 
       <application>AT-SPI2</application> this is now possible.
@@ -45,7 +45,7 @@
 
       <listitem><para>
         Using the overview mode with a keyboard works better than ever. In
-        addition to being fully keyboard navigable, users of the screenreader
+        addition to being fully keyboard navigable, users of the screen reader
         <application>Orca</application> will experience much more reliable
         and accurate presentation while navigating.
       </para></listitem>
@@ -63,8 +63,8 @@
       </para></listitem>
       <listitem><para>
         GNOME's Accessibility Implementation Library 
-        <application>Gail</application> has been completely merged into GTK+;
-        bringing GNOME yet another step closer to accessibility which is built
+        <application>Gail</application> has been completely merged into GTK+,
+        bringing GNOME yet another step closer to accessibility that's built
         in, not bolted on.
       </para></listitem>
    </itemizedlist>
diff --git a/help/C/rndevelopers.xml b/help/C/rndevelopers.xml
index e797357..3718dbc 100644
--- a/help/C/rndevelopers.xml
+++ b/help/C/rndevelopers.xml
@@ -11,7 +11,7 @@
  <title>What's New for Developers</title>
 	<para>
 		The following changes are important for developers using the GNOME
-		&gnomeversion; developer platform. If you are not interested in
+		&gnomeversion; Developer Platform. If you are not interested in
 		changes for developers, you can skip
 		forward to <xref linkend="rni18"/>.
 	</para>
@@ -19,7 +19,7 @@
 	<para>
    Included in GNOME &gnomeversion; is the latest release of the GNOME Developer
    Platform. This consists of a set of API- and ABI-stable libraries available
-   under the GNU LGPL which can be used for the development of cross-platform
+   under the GNU LGPL that can be used for the development of cross-platform
    applications.
 	</para>
 
@@ -28,7 +28,7 @@
   </para>
 
 	<sect2 id="glib">
-	  <title>Glib &glibversion;</title>
+	  <title>GLib &glibversion;</title>
    <para>
      GNOME's low-level software utility library <application>GLib</application> has seen various improvements:
    </para>
@@ -39,72 +39,72 @@
     </para></listitem>
 	  <listitem><para>
       <application>GLib</application> now installs a separate header for Unix-specific APIs:
-      <filename>glib-unix.h</filename>. Among other things, it provides a mainloop source for Unix signals
+      <filename>glib-unix.h</filename>. Among other things, it provides a mainloop source for Unix signals.
     </para></listitem>
 	  <listitem><para>
-      <classname>GDBus</classname> supports the 'object manager' pattern with a number of new interfaces
+      <classname>GDBus</classname> supports the 'object manager' pattern with a number of new interfaces.
     </para></listitem>
 	  <listitem><para>
       <classname>GDBus</classname> has a code generator now:
-      <command>gdbus-codegen</command>
+      <command>gdbus-codegen</command>.
     </para></listitem>
 	  <listitem><para>
-      Atomic operations have been rewritten to use gcc builtins; calls with explicit casts may be problematic
+      Atomic operations have been rewritten to use gcc builtins; calls with explicit casts may be problematic.
     </para></listitem>
 	  <listitem><para>
-      Atomic operations on pointers have been added, including bit-locks on pointer-size locations
+      Atomic operations on pointers have been added, including bit-locks on pointer-size locations.
     </para></listitem>
 	  <listitem><para>
-      The units policy has been changed to prefer <acronym>SI</acronym> units, <function>g_format_size_for_display</function>() has been deprecated in favor of <function>g_format_size</function>()
+      The units policy has been changed to prefer <acronym>SI</acronym> units; <function>g_format_size_for_display</function> has been deprecated in favor of <function>g_format_size</function>.
     </para></listitem>
 	  <listitem><para>
-      Support for <acronym>HMAC</acronym> digests has been added: <classname>GHmac</classname>
+      Support for <acronym>HMAC</acronym> digests has been added: <classname>GHmac</classname>.
     </para></listitem>
 	  <listitem><para>
       An interface for certificate and key lookup has been added:
-      <classname>GTlsDatabase</classname>. An implementation is provided by glib-networking
+      <classname>GTlsDatabase</classname>. An implementation is provided by glib-networking.
     </para></listitem>
 	 </itemizedlist>
   </sect2>
 
 	<sect2 id="gtk">
-	  <title>Gtk &gtkversion;</title>
+	  <title>GTK+ &gtkversion;</title>
 	 <para>
 	  GTK+ &gtkversion; is the latest release of the GTK+ toolkit, which is at the heart
 		of GNOME. GTK+ &gtkversion; includes new features for developers, as
-		well as extensive bug fixing.
+		well as extensive bug fixes.
 	 </para>
 	 <itemizedlist>
 	  <listitem><para>
-      Entries can contain 'hints' now, see <function>gtk_entry_set_placeholder_text</function>()
+      Entries can now contain hints. See <function>gtk_entry_set_placeholder_text</function>.
     </para></listitem>
 	  <listitem><para>
-      Many more widgets support height-for-width geometry management, it is important to set reasonable sizes on labels and check window sizes
+      Many more widgets support height-for-width geometry management. It is important to set reasonable sizes on labels and check window sizes.
     </para></listitem>
 	  <listitem><para>
       New widgets:
       <itemizedlist>
         <listitem><para>
-          <classname>GtkLockButton</classname>, for privileged operations (as seen in some control-center panels)
+          <classname>GtkLockButton</classname> for privileged operations, as seen in some control-center panels.
         </para></listitem>
         <listitem><para>
-          <classname>GtkOverlay</classname>, for 'floating' controls over a content area (as seen in web browsers)
+          <classname>GtkOverlay</classname> for floating controls over a content area, as seen in web browsers.
         </para></listitem>
         <listitem><para>
-          <classname>GtkFontChooserDialog</classname>, a new font selection dialog
+          <classname>GtkFontChooserDialog</classname>, a new font selection dialog.
         </para></listitem>
       </itemizedlist>
     </para></listitem>
 	  <listitem><para>
-      Much improved CSS theming support, including style classes for primary and inline toolbars 
+      Much improved CSS theming support, including style classes for primary and inline toolbars.
 	  </para></listitem>
 	  <listitem><para>
-      The HTML backend called "Broadway" that renders in a browser 
-      by using websockets 
+      The HTML backend <application>Broadway</application>, which renders in a browser 
+      by using websockets,
       <ulink url="http://blogs.gnome.org/alexl/2011/03/15/gtk-html-backend-update/";>has been improved</ulink> 
       but is still experimental. 
-      This potentially allows to either run your own apps on your server and 
-      access it from anywhere, and to put it on a public server that spawns a 
+      This potentially allows you to either run your own apps on your server and 
+      access it from anywhere, or to put it on a public server that spawns a 
       new instance of the application for every user. Note that this requires 
       compiling GTK+ with 
       <varname>--enable-x11-backend --enable-broadway-backend</varname> and 
@@ -113,7 +113,7 @@
 	  <listitem><para>
       Support for reftests 
       <ulink url="http://blogs.gnome.org/otte/2011/05/05/reftests/";>has been added</ulink> 
-      to make it easier to write testcases.
+      to make it easier to write test cases.
 	  </para></listitem>
 	  <listitem><para>
       Various GTK+ performance improvements 
@@ -137,10 +137,10 @@
 GNOME core modules now only depend on introspection-based Python bindings (<application>pygobject-3</application>) and hence <application>pygtk</application>, <application>gnome-python</application> and <application>gnome-python-desktop</application> are not required anymore.
   		</para></listitem>
 	    <listitem><para>
-        Several applications (for example <application>Accerciser</application>, <application>Dasher</application>, <application>GHex</application>, <application>gnome-video-arcade</application>, the graphical debugger <application>Nemiver</application> and the passwords and encryption keys management tool <application>Seahorse</application>) now use <classname>GSettings</classname> as storage backend instead of <application>GConf</application>.
+        Several applications (for example <application>Accerciser</application>, <application>Dasher</application>, <application>GHex</application>, <application>gnome-video-arcade</application>, the graphical debugger <application>Nemiver</application>, and the passwords and encryption keys management tool <application>Seahorse</application>) now use <classname>GSettings</classname> as storage backend instead of <application>GConf</application>.
   		</para></listitem>
 	    <listitem><para>
-         Several packages (for example the browser <application>Epiphany</application>) 
+         Several packages, such as the <application>Epiphany</application> web browser,
          have been converted from using 
          <ulink url="http://developer.gnome.org/gio/2.30/ch29.html";><application>dbus-glib</application>
          to <classname>GDBus</classname></ulink> and from 
@@ -151,10 +151,10 @@ GNOME core modules now only depend on introspection-based Python bindings (<appl
   </sect2>
 
 	<sect2 id="jhbuild">
-	  <title>Easier to Compile GNOME With Jhbuild</title>
+	  <title>Easier to Compile GNOME With JHBuild</title>
     <!-- from https://mail.gnome.org/archives/desktop-devel-list/2011-July/msg00091.html -->
     <para>
-      GNOME's build tool <application><ulink url="http://developer.gnome.org/jhbuild/";>Jhbuild</ulink></application> 
+      GNOME's build tool <application><ulink url="http://developer.gnome.org/jhbuild/";>JHBuild</ulink></application> 
       does not build a module anymore if the version installed on your system is
       recent enough. This is controlled by the configuration option
       <varname>partial_build</varname> and it is enabled by default. The command
@@ -176,16 +176,15 @@ GNOME core modules now only depend on introspection-based Python bindings (<appl
 The classic (static) Python bindings were removed for PyGObject 3.0 and only
 dynamic Python bindings are provided (via introspection). PyGObject 2 and 3 are
 parallel-installable as introspection is turned off by default in the PyGObject
-2 packages. Information <ulink url="http://www.j5live.com/2011/08/14/announce-pygobject-2-90-1-released-3-0-pre-release/";>how to port applications from PyGObject 2 to PyGObject 3</ulink> is available.
+2 packages. Information on <ulink url="http://www.j5live.com/2011/08/14/announce-pygobject-2-90-1-released-3-0-pre-release/";>how to port applications from PyGObject 2 to PyGObject 3</ulink> is available.
 <!-- Taken from http://www.j5live.com/2011/07/18/pygobject-invoke-rewrite-branch-merged-with-master/ and http://www.j5live.com/2011/08/14/announce-pygobject-2-90-1-released-3-0-pre-release/ -->
 		</para></listitem>
 	  <listitem><para>
       <application>Tracker</application> version 0.12 provides support for 
       <application>Firefox</application> â 4.0, 
-      <application>Thunderbird</application> â 5.0, MeeGoTouch and 
-      several additional SPARQL parameters, for extracting information 
-      from EPub files, for local XDG directories for desktop files, and 
-      many bugfixes.
+      <application>Thunderbird</application> â 5.0, MeeGoTouch,
+      several additional SPARQL parameters, extracting information 
+      from EPub files, and local XDG directories for desktop files.
       <!-- https://mail.gnome.org/archives/tracker-list/2011-September/msg00013.html -->
 		</para></listitem>
 	  <listitem><para>
@@ -196,23 +195,23 @@ parallel-installable as introspection is turned off by default in the PyGObject
 As part of the aforementioned effort to use and promote PKCS#11 as glue between encryption libraries, various parts of <application>gnome-keyring</application> have been split into <ulink url="http://p11-glue.freedesktop.org/";>desktop-independent libraries</ulink>.
 		</para></listitem>
 	  <listitem><para>
-      <application>Gtksourceview</application> now supports syntax highlighting of Markdown and Standard ML files.
+      <application>GtkSourceView</application> now supports syntax highlighting of Markdown and Standard ML files.
 		</para></listitem>
 	  <listitem><para>
      <application>Evolution-Data-Server</application> received many introspection support fixes.
 		</para></listitem>
 	  <listitem><para>
-     <application><ulink url="http://telepathy.freedesktop.org/wiki/Folks";>libfolks</ulink></application> now includes an Evolution-Data-Server backend which is for example used by <application>Contacts</application>.
+     <application><ulink url="http://telepathy.freedesktop.org/wiki/Folks";>libfolks</ulink></application> now includes an Evolution-Data-Server backend, which is used by the new <application>Contacts</application> application.
 		</para></listitem>
 	  <listitem><para>
       Among the tools used for documentation processing, 
       <application>gnome-doc-utils</application> and 
-      <application>xml2po</application> slowly get replaced by 
+      <application>xml2po</application> are slowly being replaced by 
       <application>yelp-tools</application> and 
       <application>itstool</application>. 
       <application>yelp-xsl</application> includes a few experimental 
       <ulink url="http://projectmallard.org/";>Mallard</ulink> 
-      extensions (such as conditional processing).
+      extensions, such as conditional processing and dynamic glossaries.
       <!-- http://blogs.gnome.org/shaunm/2011/04/29/mallard-conditional-processing/ and http://mail.gnome.org/archives/gnome-doc-list/2011-May/msg00018.html -->
 		</para></listitem>
 	</itemizedlist>
diff --git a/help/C/rninstallation.xml b/help/C/rninstallation.xml
index 28c73cd..4515cfd 100644
--- a/help/C/rninstallation.xml
+++ b/help/C/rninstallation.xml
@@ -9,14 +9,14 @@
   <title>Getting GNOME &gnomeversion;</title>
 
  <para>
-   To install or upgrade your machine to GNOME &gnomeversion;, we recommend to
+   To install or upgrade your machine to GNOME &gnomeversion;, we recommend you
    install the official packages provided by your vendor or distribution.
    Popular distributions will make GNOME &gnomeversion; available very soon, and
    some already have development versions with GNOME &gnomeversion; available.
  </para>
 
  <para>
-   If you want to try out GNOME, download one of our Live Images. These are
+   If you want to try out GNOME, download one of our live images. These are
    available on our <ulink url="http://www.gnome.org/getting-gnome/";>Getting
      GNOME</ulink> page.
  </para>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]