release-notes r920 - in branches/gnome-2-22: . help/C



Author: shaunm
Date: Thu Mar  6 20:33:50 2008
New Revision: 920
URL: http://svn.gnome.org/viewvc/release-notes?rev=920&view=rev

Log:
* help/C/*.xml:
- Various language tweaks and DocBook issues


Modified:
   branches/gnome-2-22/ChangeLog
   branches/gnome-2-22/help/C/release-notes.xml
   branches/gnome-2-22/help/C/rna11y.xml
   branches/gnome-2-22/help/C/rnadmins.xml
   branches/gnome-2-22/help/C/rndevelopers.xml
   branches/gnome-2-22/help/C/rni18n.xml
   branches/gnome-2-22/help/C/rninstallation.xml
   branches/gnome-2-22/help/C/rnlookingforward.xml
   branches/gnome-2-22/help/C/rnmemorial.xml
   branches/gnome-2-22/help/C/rnusers.xml

Modified: branches/gnome-2-22/help/C/release-notes.xml
==============================================================================
--- branches/gnome-2-22/help/C/release-notes.xml	(original)
+++ branches/gnome-2-22/help/C/release-notes.xml	Thu Mar  6 20:33:50 2008
@@ -46,20 +46,20 @@
 				GNOME's focus is ease of use, stability, and first class
 				internationalization and accessibility support. 
 				GNOME is Free and Open Source Software and provides all of the common
-				tools computer users expect of a modern computing environment (email,
-				groupware, web browsing, file management, multimedia, games),
-				as well as a flexible and powerful platform for software developers both
-				on the desktop and in mobile applications.
+				tools computer users expect of a modern computing environment, such as
+        email, groupware, web browsing, file management, multimedia, and games.
+        Furthermore, GNOME provides a flexible and powerful platform for software
+        developers, both on the desktop and in mobile applications.
 			</para>
 
       <!-- FIXME: nice screenshot of 2.22 -->
 
 			<para>
 				The GNOME Desktop is released every six months and contains many new features,
-				improvements, "bug" fixes and translations, and GNOME &gnomeversion; continues this
+				improvements, bug fixes, and translations. GNOME &gnomeversion; continues this
 				tradition. To learn more about GNOME and the qualities that
-				distinguish it from other computer desktop environments (like usability,
-				accessibility, internationalization and freedom) visit the
+				distinguish it from other computer desktop environments (such as usability,
+				accessibility, internationalization, and freedom) visit the
 				<ulink url="http://www.gnome.org/about";>About GNOME</ulink> page on our
 				website.
 			</para>

Modified: branches/gnome-2-22/help/C/rna11y.xml
==============================================================================
--- branches/gnome-2-22/help/C/rna11y.xml	(original)
+++ branches/gnome-2-22/help/C/rna11y.xml	Thu Mar  6 20:33:50 2008
@@ -14,14 +14,15 @@
 		<para>
 			<application>Orca</application>, GNOME's screenreading technology, has
 			many exciting improvements in 2.22. Close collaboration with Mozilla has
-			led to excellent accessibility in <application>Firefox 3</application>.
-			New is Orca is support for Accessible Rich Internet Applications (ARIA)
+			led to excellent accessibility in <application>Firefox 3</application>,
+      including support in <application>Orca</application> for Accessible Rich
+      Internet Applications (ARIA)
 			and Live Regions. This allows for much richer accessibility with today's
 			modern, dynamic web applications.
 		</para>
 		<para>
-			Orca in GNOME 2.22 also adds support for level 2 contracted braille.
-			Lots of work has also gone into improving its quality and stability.
+			<application>Orca</application> in GNOME 2.22 also adds support for level 2 contracted braille.
+			A Lot of work has also gone into improving its quality and stability.
 		</para>
 
 		<!-- FIXME: screenshot of contracted braille something -->
@@ -30,7 +31,7 @@
 			The screen magnifier has been improved and can now take advantage of
 			technology like X compositing to allow smoother scrolling and fullscreen
 			scrolling on hardware that supports it. There is also improved support for
-			colourblind filters.
+			colorblind filters.
 		</para>
 	</sect2>
 
@@ -47,7 +48,7 @@
 			<listitem><para>the ability to open the contextual menu with only one
 											mouse button; and</para></listitem>
 			<listitem><para>the ability to perform different types of clicks (e.g.
-											single click, double click, context click and dragging)
+											single click, double click, context click, and dragging)
 											without using a
 											mouse button (usually referred to as a
 											<emphasis>dwelling</emphasis>).</para></listitem>

Modified: branches/gnome-2-22/help/C/rnadmins.xml
==============================================================================
--- branches/gnome-2-22/help/C/rnadmins.xml	(original)
+++ branches/gnome-2-22/help/C/rnadmins.xml	Thu Mar  6 20:33:50 2008
@@ -17,9 +17,9 @@
 			extra privileges, e.g. for administrative applications.
 		</para>
 		<para>
-			Using PolicyKit, Administrators can now configure system-wide settings.
-			For example, you may allow some user to adjust the date and time of the
-			clock or you might grant specific users the ability to start and stop
+			Using PolicyKit, administrators can now configure system-wide settings.
+			For example, you might allow some user to adjust the date and time of the
+			clock, or you might grant specific users the ability to start and stop
 			system services.
 		</para>
 
@@ -40,17 +40,18 @@
 
 		<para>
 			GNOME's system administration tools now monitor for changes in the
-			configuration files they're editing. This means if another administrator
-			changes the configuration, your display is updated to reflect this.
+			configuration files they're editing. This means that if another
+      administrator changes the configuration, your display is updated
+      to reflect those changes.
 		</para>
 
 		<para>
-			The Share Administrator <!-- FIXME: is this the name? --> now allows you
+			The <application>Shared Folders</application> tool now allows you
 			to edit the SMB user database (smbpasswd).
 		</para>
 
 		<para>
-			The Network Administrator <!-- FIXME: same thing --> can now set up
+			The <application>Network</application> tool can now set up
 			PPPoE and GPRS connections.
 		</para>
 	</sect2>

Modified: branches/gnome-2-22/help/C/rndevelopers.xml
==============================================================================
--- branches/gnome-2-22/help/C/rndevelopers.xml	(original)
+++ branches/gnome-2-22/help/C/rndevelopers.xml	Thu Mar  6 20:33:50 2008
@@ -9,7 +9,7 @@
 	<title>What's New For Developers</title>
 
 	<para>
-		The GNOME &gnomeversion; Developers' Platform provides a stable base for independent
+		The GNOME &gnomeversion; Developer Platform provides a stable base for independent
 		software developers to create third-party applications. GNOME and its
 		platform are licensed to allow the creation of both free and proprietary
 		software to run on top of GNOME.
@@ -28,18 +28,10 @@
 		     http://fedoraproject.org/wiki/Features/Gvfs and the GIO API docs -->
 
 		<para>
-			GVFS is a userspace virtual filesystem with backends for things like SFTP,
-			FTP, DAV, SMB, ObexFTP, etc.
+			GVFS is a userspace virtual file system with backends for protocols like SFTP,
+			FTP, DAV, SMB, ObexFTP.
 			GVFS is the replacement for GNOME-VFS. GNOME-VFS should now be considered
-			deprecated and developers should not use it in new applications.
-		</para>
-
-		<para>
-			GVFS/GIO aims to provide a modern, easy-to-use VFS system. Its goal is to
-			provide an API that developers prefer over raw POSIX IO calls. Rather than
-			closing the POSIX IO API, it provides a higher-level, document-centric
-			interface. As well as reading and writing files, GIO provides facilities
-			for file monitoring, asynchronous IO and filename completion.
+			deprecated, and developers should not use it in new applications.
 		</para>
 
 		<para>
@@ -47,29 +39,35 @@
 		</para>
 		<itemizedlist>
 			<listitem><para>
-				GIO, which is a new shared library that is part of
-				<application>GLib</application> and provides
-				the API for GVFS; and
+				GIO, a new shared library that is part of GLib and provides the API for GVFS; and
 			</para></listitem>
 			<listitem><para>
-				GVFS itself, which is a new package containing backends for various file
+				GVFS itself, a new package containing backends for various file
 				system types and protocols such as SFTP, FTP, DAV, SMB and ObexFTP.
 			</para></listitem>
 		</itemizedlist>
 
 		<para>
-			The way GVFS works is that it runs a single master daemon (gvfsd) that
+			GVFS/GIO aims to provide a modern, easy-to-use VFS system. Its goal is to
+			provide an API that developers prefer over raw POSIX IO calls. Rather than
+			cloning the POSIX IO API, it provides a higher-level, document-centric
+			interface. As well as reading and writing files, GIO provides facilities
+			for file monitoring, asynchronous IO, and filename completion.
+		</para>
+
+		<para>
+			GVFS works by running a single master daemon (gvfsd) that
 			keeps track of the current GVFS mounts. Each mount is run in a separate
-			daemon (some mounts share a daemon process, but most don't). Clients talk
-			to the mounts with a combination of D-BUS calls (on the session bus and
-			using peer-to-peer D-BUS) and a custom protocol for file contents.
-			Moving the backends out-of-process minimises dependency bloat for
+			daemon.  (Some mounts share a daemon process, but most don't.) Clients talk
+			to the mounts with a combination of D-Bus calls (on the session bus and
+			using peer-to-peer D-Bus) and a custom protocol for file contents.
+			Moving the backends out of process minimises dependency bloat for
 			applications and makes the whole system more robust.
 		</para>
 
 		<para>
 			GVFS also offers a FUSE mountpoint in <filename>~/.gvfs/</filename>
-			so that GVFS mounts can be exposed to legacy applications utilising
+			so that GVFS mounts can be exposed to legacy applications using
 			standard POSIX IO.
 		</para>
 
@@ -98,12 +96,12 @@
 
 			<para>
 				Although GVFS fixes a lot of problems that previously existed by using
-				GNOME-VFS there are currently some feature regressions. Most notably is
+				GNOME-VFS, there are currently some feature regressions. Most notable is
 				the lack of fonts:// and themes:// targets.
 			</para>
 			<para>
 				These issues will be fixed as soon as possible. There are also some
-				applications that still remain to be ported over to GVFS, the state of
+				applications that still remain to be ported over to GVFS. The state of
 				this port is <ulink url="http://live.gnome.org/GioPort";>documented
 				online</ulink>.
 			</para>
@@ -115,10 +113,10 @@
 		<title>Anjuta IDE</title>
 
 		<para>
-			The <application>Anjuta</application> IDE has been made part of the GNOME
-			Developer Suite. Anjuta is a GNOME integrated IDE that offers many
+			The <application>Anjuta</application> IDE is now a part of the GNOME
+			Developer Suite. Anjuta is a GNOME-integrated IDE that offers many
 			features for developers, such as an integrated debugger, integrated Glade
-			UI editor and Valgrind interface.
+			UI editor, and a Valgrind interface.
 		</para>
 	</sect2>
 

Modified: branches/gnome-2-22/help/C/rni18n.xml
==============================================================================
--- branches/gnome-2-22/help/C/rni18n.xml	(original)
+++ branches/gnome-2-22/help/C/rni18n.xml	Thu Mar  6 20:33:50 2008
@@ -11,8 +11,8 @@
     <para>
     Thanks to members of the worldwide <ulink
     url="http://developer.gnome.org/projects/gtp/";>GNOME Translation
-    Project</ulink>, GNOME &version; offers support for 45 languages (at least 80 percent of
-    strings translated), including the user and administration manuals for many languages.
+    Project</ulink>, GNOME &version; offers support for 45 languages with at least 80 percent of
+    strings translated, including the user and administration manuals for many languages.
 
   </para>
 

Modified: branches/gnome-2-22/help/C/rninstallation.xml
==============================================================================
--- branches/gnome-2-22/help/C/rninstallation.xml	(original)
+++ branches/gnome-2-22/help/C/rninstallation.xml	Thu Mar  6 20:33:50 2008
@@ -9,17 +9,19 @@
 	<title>Installing GNOME</title>
 
 	<para>
-		You can try out GNOME &gnomeversion; via the LiveCD which contains all of the software
-		included in GNOME &gnomeversion; on a single CD. It can be downloaded from the GNOME
+		You can try out GNOME &gnomeversion; with the LiveCD, which contains all of the software
+		included in GNOME &gnomeversion; on a single CD.  You can boot your computer directly
+    from the LiveCD without installing anything.
+    The LiveCD 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
+		will make GNOME &gnomeversion; available very soon, and some already have
 		development versions with GNOME &gnomeversion; available. You can get a list of
-		distributions who ship GNOME, and discover the latest versions they ship on our
+		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>
@@ -30,8 +32,8 @@
 		<ulink url="http://www.gnome.org/projects/garnome/";>GARNOME</ulink> builds GNOME
 		from release tarballs. You will need GARNOME &gnomeversion;.x to build GNOME &gnomeversion;.x.
 		There is also <ulink
-		url="http://www.freedesktop.org/Software/jhbuild";>jhbuild</ulink> which is
-		designed to build the latest GNOME from svn. You can also use jhbuild to build
+		url="http://www.freedesktop.org/Software/jhbuild";>jhbuild</ulink>, which is
+		designed to build the latest GNOME from SVN. You can use jhbuild to build
 		GNOME &gnomeversion;.x by using the <filename>gnome-&gnomeversion;</filename> moduleset.
 	</para>
 

Modified: branches/gnome-2-22/help/C/rnlookingforward.xml
==============================================================================
--- branches/gnome-2-22/help/C/rnlookingforward.xml	(original)
+++ branches/gnome-2-22/help/C/rnlookingforward.xml	Thu Mar  6 20:33:50 2008
@@ -25,8 +25,8 @@
 		 Telepathy communications framework;</para></listitem>
 		 <listitem><para>the often requested column and list views in GNOME's
 		 <application>File Manager</application>;</para></listitem>
-		 <listitem><para>the completion of the GNOME-VFS to GVFS port; and</para></listitem>
-		 <listitem><para>bug fixes, performance improvements and memory
+		 <listitem><para>the completion of the port from GNOME-VFS to GVFS; and</para></listitem>
+		 <listitem><para>bug fixes, performance improvements, and memory
 		 improvements throughout the desktop.</para></listitem>
    </itemizedlist>
   </para>

Modified: branches/gnome-2-22/help/C/rnmemorial.xml
==============================================================================
--- branches/gnome-2-22/help/C/rnmemorial.xml	(original)
+++ branches/gnome-2-22/help/C/rnmemorial.xml	Thu Mar  6 20:33:50 2008
@@ -21,12 +21,12 @@
 	</figure>
 
 	<para>
-	  Raphael Higino was a long time contributor to GNOME's Brazillian translation
+	  Raphael Higino was a long-time contributor to GNOME's Brazillian translation
 		effort and was very passionate about GNOME. He was a very dependable member
 		of the team and was always willing to lend a guiding hand to new
-		contributors and he had made a number of very good friends in the community.
+		contributors.  He had made a number of very good friends in the community.
 		Raphael passed away last year in a motorcycle accident at only 24 years of
-		age. His dedication, hard work and companionship will always be cherished by
+		age. His dedication, hard work, and companionship will always be cherished by
 		the community and all those whose lives he touched.
 	</para>
 

Modified: branches/gnome-2-22/help/C/rnusers.xml
==============================================================================
--- branches/gnome-2-22/help/C/rnusers.xml	(original)
+++ branches/gnome-2-22/help/C/rnusers.xml	Thu Mar  6 20:33:50 2008
@@ -11,8 +11,8 @@
 	<para>
 			The GNOME Project's focus on users and usability continues in GNOME &gnomeversion;
 			with its hundreds of bug fixes and user-requested improvements. The
-			sheer number of enhancements make it impossible to list every change and
-			improvement made but we hope to highlight some of the
+			sheer number of enhancements makes it impossible to list every change and
+			improvement made, but we hope to highlight some of the
 			more exciting user-oriented features in this release of GNOME.
 	</para>
 
@@ -22,11 +22,11 @@
 		<!-- FIXME: cheese screenshot -->
 		<para>
 			GNOME 2.22 introduces a new application,
-			<application>Cheese</application>. Cheese lets you take photos and make
-			videos using your computer's webcam apply a range of different effects
-			(like mauve, noir/blanc, shagadelic and warp) that you can share with
-			your friends, load into
-			<application>F-Spot</application> or set as your account photo.
+			<application>Cheese</application>. <application>Cheese</application> lets
+      you take photos and make videos using your computer's webcam.  You can apply
+      a range of different effects like mauve, noir/blanc, shagadelic, and warp.
+      You can share these photos and videos with your friends, load them into
+			<application>F-Spot</application>, or set them as your account photo.
 		</para>
 	</sect2>
 
@@ -37,30 +37,33 @@
 			GNOME 2.22 introduces window compositing on capable platforms. Fitting
 			with GNOME's "keeping it simple" policy, the features are very low key.
 			The most noticeable changes are drop shadows on windows, live previews when
-			switching windows with Alt-Tab and transparency effects.
+			switching windows with <keycombo><keycap>Alt</keycap><keycap>Tab</keycap></keycombo>,
+      and transparency effects.
 		</para>
 		<para>
 			Not all graphics hardware reliably supports compositing, so this feature
 			is currently turned off by default and not yet exposed in the preferences.
 			If you know you have graphics hardware that supports compositing,
-			you can run the command:
+			you can run the following command:
 			<userinput><command>gconftool-2 <option>-s</option>
 				<option>--type</option> <parameter>bool</parameter>
 				<parameter>/apps/metacity/general/compositing_manager</parameter>
 				<parameter>true</parameter></command>
-			</userinput> from the run dialog (or set <parameter>false</parameter> to disable).
+			</userinput> from the run dialog, or set the key in the
+      <application>Configuration Editor</application>.  To disable compositing,
+      set the key to <parameter>false</parameter>.
 		</para>
 	</sect2>
 
 	<sect2 id="sect:gvfs">
 		<title>Better Networked Filesystems</title>
 		<para>
-			GNOME 2.22 introduces <application>GVFS</application> a new
+			GNOME 2.22 introduces <application>GVFS</application>: a new
 			network-transparent virtual filesystem layer for GTK+. GVFS is designed to
-			overcome the shortcomings of the older GNOME-VFS system such as
-			remembering login credentials for the entire session and being more
-			resilient to failures.
-			Many GNOME applications are already using GVFS including all of the core
+			overcome the shortcomings of the older GNOME-VFS system.  Improvements over
+      GNOME-VFS include remembering login credentials for the entire session and
+      being more resilient to failures.
+			Many GNOME applications are already using GVFS, including all of the core
 			applications.
 		</para>
 		<para>
@@ -79,30 +82,32 @@
 			GNOME's <application>File Manager</application> is now smarter about
 			removable media, and will show you an information bar with possible
 			actions when you insert removable media or
-			browse to a folder from a removable drive.
+			browse to a folder on a removable drive.
 		</para>
 		<!-- FIXME : awesome screenshot of cluebar -->
 		<para>
 			Technical information about GVFS is available in <xref
-			linkend="sect:gvfs-gio" /> of the What's New For Developers section.
+			linkend="sect:gvfs-gio" /> under What's New For Developers.
 		</para>
 	</sect2>
 
 	<sect2 id="sect:totem">
-		<title>DVD, Digital TV and more</title>
+		<title>DVD, Digital TV, and More</title>
 
 		<para>
 			GNOME's <application>Movie Player</application> now offers improved
-			support for DVD playback. Also new in GNOME 2.22 is support for
-			digital television (DVB).
-		</para>
-
-		<!-- FIXME: DVB screenshot -->
+			support for DVD playback as well as support for digital television (DVB).
 
+      <!--
+		</para>
+		FIXME: DVB screenshot.  If you get a screenshot in, go ahead and split this
+    into two paragraphs.  Otherwise, leave it as one.
 		<para>
-			Also appearing in 2.22 are a selection of new plugins, including support
-			for MythTV, Youtube and Tracker-based searching. Also new is playlist
-			sharing and the ability to select subtitles for files.
+      -->
+
+			Also appearing in 2.22 is a selection of new plugins, including support
+			for MythTV, Youtube, and Tracker-based searching.   This release also
+      features playlist sharing and the ability to select subtitles for files.
 		</para>
 
 		<para>
@@ -118,9 +123,9 @@
 
 		<para>
 			No need to do any more mental arithmetic to work out what time your
-			teleconference starts in Sydney, GNOME 2.22 now has internationalisation
-			built into its clock. Add locations from around the world to see the local
-			time and weather.
+			teleconference starts in Sydney. GNOME 2.22 now has internationalisation
+			built into its clock. You can add multiple locations from around the world
+      to see the local time and weather.
 		</para>
 
 		<!-- FIXME: screenshot -->
@@ -150,14 +155,14 @@
 		<para>
 			New in GNOME 2.22 is the <application>Remote Desktop Viewer</application>.
 			This application complements the existing remote desktop server
-			support in GNOME, it features the ability to discover machines on the
-			local network and bookmark your favourites.
+			support in GNOME. It features the ability to discover machines on the
+			local network and bookmark your favorites.
 		</para>
 
 		<!-- FIXME: vinagre screenshot -->
 
 		<para>
-			Users desiring more control over the remove desktop server will also
+			Users desiring more control over the remote desktop server will also
 			appreciate the addition of an <guilabel>Advanced</guilabel> tab in the
 			properties dialog.
 		</para>
@@ -168,10 +173,10 @@
 
 		<para>
 			GNOME 2.22 also features many bug fixes and user-required enhancements
-			from the last 6 months of development including:
+			from the last six months of development, including:
 		</para>
 		<itemizedlist>
-			<listitem><para>directly open Evolution contacts in
+			<listitem><para>directly open <application>Evolution</application> contacts in
 											<application>Deskbar</application>;</para></listitem>
 			<listitem><para>improved printing in <application>Text
 															Editor</application>;</para></listitem>
@@ -181,7 +186,7 @@
 											<application>Epiphany</application>;</para></listitem>
 			<listitem><para>LZMA (7-zip) support in <application>Archive
 															Manager</application>;</para></listitem>
-			<listitem><para>Inhibit automatic suspend/hibernation while burning
+			<listitem><para>inhibit automatic suspend and hibernation while burning
 											CDs;</para></listitem>
 			<listitem><para><application>Document Viewer</application> is now faster
 			and uses less memory;</para></listitem>
@@ -190,7 +195,7 @@
 			<listitem><para><application>Tomboy</application> can now organise your
 			notes into notebooks;</para></listitem>
 			<listitem><para><application>Sound Juicer</application> now supports more
-			meta-data, including disc number and year;</para></listitem>
+			metadata, including disc number and year;</para></listitem>
 			<listitem><para>extensive improvements to
 			<application>Calculator</application>'s precision and usability;</para></listitem>
 			<listitem><para><application>Keyring Manager</application> has been



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]