[release-notes/gnome-3-10] tweaks

[Allan Day <allanday src gnome org>]

commit ad5ec4bfa39c0ae65c5fbf255d9c4b4e72e3d85a
Author: Allan Day <allanpday gmail com>
Date:   Tue Sep 17 12:06:24 2013 +0100

    tweaks

 help/C/developers.page   |    4 ++--
 help/C/index.page        |   12 ++++++------
 help/C/more-core-ux.page |   22 +++++++++++-----------
 3 files changed, 19 insertions(+), 19 deletions(-)
---
diff --git a/help/C/developers.page b/help/C/developers.page
index 4723734..e01f3f5 100644
--- a/help/C/developers.page
+++ b/help/C/developers.page
@@ -61,10 +61,10 @@
     <p>Some support for installed tests</p>
     <p>GApplication: TO DO</p>
     <list>
-      <item><p>busy state</p></item>
+      <item><p>Applications can now signal their busy state to a desktop shell, such as for a long-running 
operation or loading state.</p></item>
       <item><p>org.freedesktop.Application</p></item>
       <item><p>D-Bus activation from desktop files</p></item>
-      <item><p>Actions in desktop files</p></item>
+      <item><p>If an application is DBus activatable, actions from its <code>.desktop</code> file are now 
translated into <code>GActions</code>.</p></item>
     </list>
   </section>
 
diff --git a/help/C/index.page b/help/C/index.page
index 90d8668..4968746 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -31,26 +31,26 @@
   <p>New features in GNOME &gnomeversion; include:</p>
 
   <section id="wayland">
-    <title>Next Stop Wayland</title>
-    <p><app>Wayland</app> is the next generation GNOME display server. It promises to deliver smoother 
graphics performance, with improved animations and transitions. <app>Wayland</app>'s modern architecture will 
provide greater flexibility for developers, and enable more secure sandboxed applications. &gnomeversion; 
introduces experimental <app>Wayland</app> support, which allows GNOME 3 and GNOME applications to be run 
directly on top of Wayland. This is an important milestone on the road to full <app>Wayland</app> adoption, 
and will developers to test their software in a <app>Wayland</app> environment. More details about this can 
be found in the <link type="topic" xref="developers#wayland">developer notes</link>.</p>
+    <title>Wayland</title>
+    <p><app>Wayland</app> is the next generation GNOME display server. It promises to deliver smoother 
graphics, with improved animations and transitions. <app>Wayland</app>'s modern architecture will provide 
greater flexibility for developers, and will enable more secure sandboxed applications. &gnomeversion; 
introduces experimental <app>Wayland</app> support, which allows GNOME 3 and GNOME applications to be run 
directly on top of Wayland. This is an important milestone on the road to full <app>Wayland</app> adoption, 
and will let developers test their software in a <app>Wayland</app> environment. More details can be found in 
the <link type="topic" xref="developers#wayland">developer notes</link>.</p>
     <media type="image" src="figures/wayland.png"/>
   </section>
 
   <section id="system-status">
     <title>Integrated System Status</title>
-    <p>GNOME &gnomeversion; features a new, redesigned system status area. In previous versions, the system 
status area was made up of a series of menus in the corner of the top bar. The new system status area 
replaces this with a single menu. This allows you to quickly see an overview of the state of your device, and 
gives a more focused top bar which only displays information that you care about. Among many improvements, 
the new menu provides easier mouse interaction, privacy enhancements, a new screen brightness slider, and a 
better aeroplane mode.</p>
+    <p>GNOME &gnomeversion; features a new, redesigned system status area. In previous versions, the system 
status area was made up of a series of menus in the corner of the top bar. The new system status area 
replaces this with a single menu. This allows you to quickly get an overview of the state of your device, and 
provides a more focused top bar which only displays information that you care about. Among many improvements, 
the new menu provides easier mouse interaction, privacy enhancements, a new screen brightness slider, and a 
better aeroplane mode.</p>
     <media type="image" src="figures/status-menu.png"/>
   </section>
 
   <section id="header-bars">
     <title>Header Bars</title>
-    <p>A new interface element has been introduced in &gnomeversion;: header bars. These merge applications' 
title bars and toolbars into a single element, reducing the amount of interface chrome within each window, 
and giving more screen space to content. Header bars also allows more dynamic application interfaces whose 
controls adjust to the current view, and they ensure that window close buttons are always present, 
irrespective of whether the window is maximized or not.</p>
+    <p>A new interface element has been introduced in &gnomeversion;: header bars. These merge applications' 
title bars and toolbars into a single element, reducing the amount of interface chrome within each window, 
and giving more screen space to content. Header bars also allow more dynamic application interfaces whose 
controls adjust to the current view, and they ensure that window close buttons are always present, 
irrespective of whether the window is maximized or not.</p>
     <media type="image" src="figures/header-bars.png"/>
   </section>
 
   <section id="new-apps">
     <title>New Applications</title>
-    <p>GNOME's mission to provide a high quality set of modern applications continues in GNOME 
&gnomeversion;. In addition to <app>Software</app> and <app>Maps</app>, there is a whole collection of other 
new applications being introduced, including <app>Music</app>, <app>Photos</app> and <app>Notes</app>. For 
more details, see <link type="topic" xref="more-apps"/>.</p>
+    <p>GNOME's mission to create a new set of core applications continues in GNOME &gnomeversion;. There is 
a whole collection of new applications in this version, including <app>Music</app>, <app>Photos</app>, 
<app>Notes</app>, <app>Software</app> and <app>Maps</app>. For more details, see below and <link type="topic" 
xref="more-apps"/>.</p>
     <media type="image" src="figures/placeholder.png"/>
   </section>
 
@@ -62,7 +62,7 @@
 
   <section id="geolocation">
     <title>Geolocation</title>
-    <p>A new geolocation framework has been created for GNOME &gnomeversion;. This allows your location to 
be automatically determined using various data sources, including your internet connection and GPS. The new 
facility is being used in a number of places. A new <gui>Automatic Time Zone</gui> setting makes your 
device's clock update when you move to different time zones, and <app>Clocks</app> will automatically show a 
clock for your current location. GNOME &gnomeversion; also introduces a <link type="topic" 
xref="more-apps#maps">new maps application</link>, which is able to automatically detect where you are and 
show a map of your location.</p>
+    <p>A new geolocation framework has been created for GNOME &gnomeversion;. This allows your location to 
be automatically determined using various data sources, including your internet connection and GPS. The new 
framework is being used in a number of places. A new <gui>Automatic Time Zone</gui> setting makes your 
device's clock update when you move to different time zones, and <app>Clocks</app> will automatically show a 
clock for your current location. GNOME &gnomeversion; also introduces a <link type="topic" 
xref="more-apps#maps">new maps application</link>, which is able to automatically detect where you are and 
show a map of your location.</p>
     <media type="image" src="figures/gnome-maps.png"/>
   </section>
 
diff --git a/help/C/more-core-ux.page b/help/C/more-core-ux.page
index b6cd679..4713a82 100644
--- a/help/C/more-core-ux.page
+++ b/help/C/more-core-ux.page
@@ -26,19 +26,19 @@
 
   <section id="app-view">
     <title>Paginated Application View</title>
-    <p>The application launching view now has pages rather than being scrolled, and has had many other 
layout and animation improvements. Pages make it easier to find the application you are looking for, and 
integrates application folders much more effectively.</p>
+    <p>The application launching view now has pages rather than being scrolled, and has had many other 
layout and animation improvements. Pages make it easier to find the application you are looking for, and 
integrates application folders much more effectively. A lot of time has been spent making this part of GNOME 
3 look and feel great, and it has some extremely nice animations.</p>
     <media type="image" src="figures/placeholder.png"/>
   </section>
 
   <section id="lock-screen">
     <title>Customize Your Lock Screen</title>
-    <p>From 3.10, it is possible to set a different image for your lock screen. This gives greater scope for 
personalization, and helps to differentiate the lock screen from your session. The lock screen image can be 
changed from the <app>Background Settings</app></p>
+    <p>From 3.10, it is possible to set a different image for your lock screen. This gives greater scope for 
personalization, and helps to differentiate the lock screen from your session. The lock screen image can be 
changed from the <app>Background Settings</app>.</p>
     <media type="image" src="figures/lock-screen.png"/>
   </section>
 
   <section id="scrolling">
     <title>Fine Scrolling</title>
-    <p>Scroll bars in GNOME now feature a new mode that allows fine scrolling. This is particularly useful 
if the scrolled area is very large, and allows precise movements within a small area. To activate fine 
scrolling, just press and hold the scroll bar handle, or hold shift and click on it.</p>
+    <p>Scroll bars in GNOME now feature a new mode that allows fine scrolling. This is particularly useful 
if the scrolled area is very large, and allows precise movements within a small area. To activate fine 
scrolling, just make a long click on a scroll bar handle, or click on the handle while holding the shift 
key.</p>
     <media type="image" src="figures/placeholder.png"/>
   </section>
 
@@ -46,10 +46,10 @@
     <title>Settings</title>
     <p>A number of areas in <app>Settings</app> have been enhanced for GNOME 3.10.</p>
     <list>
-      <item><p><gui>Date &amp; Time</gui>: these have been overhauled to make them easier to use, and now 
have a bigger, better looking time zone map and clearer options. Using the geolocation framework introduced 
in 3.10, a new <gui>Automatic Time Zone</gui> option is provided.</p></item>
-      <item><p><gui>Displays</gui>: the options for your screens and displays have been redesigned, making 
configuration much easier.</p></item>
-      <item><p><gui>Online Accounts</gui>: new online accounts have been added for 3.10, including Flickr, 
Zimbra. Chat accounts have also been integrated, rather than being provided by <app>Empathy</app>.</p></item>
-      <item><p><gui>Universal Access</gui>: the main sections have been redesigned and combined into a 
single page. This makes it easier to find the settings you are looking for.</p></item>
+      <item><p><gui>Date &amp; Time</gui>: these have been overhauled to make them easier to use, and now 
have a bigger, better looking time zone map and clearer options. A new <gui>Automatic Time Zone</gui> option 
is provided, which uses the new geolocation framework which has been introduced in 3.10.</p></item>
+      <item><p><gui>Displays</gui>: the <gui>Displays</gui> section has been completely redesigned, making 
configuration much easier.</p></item>
+      <item><p><gui>Online Accounts</gui>: chat accounts have now been integrated into <gui>Online 
Accounts</gui>, which means that you can now access all your account types in one place. You can now log into 
your Google account using <link href="https://support.google.com/accounts/answer/180744";>two-step 
verification</link>, and Flickr has been added to the list of online account types.</p></item>
+      <item><p><gui>Universal Access</gui>: the different <gui>Universal Access</gui> sections have been 
redesigned and combined into a single page. This makes it easier to find the settings you are looking 
for.</p></item>
       <item><p><gui>Background</gui>: in addition to now allowing you to change your lock screen background, 
it is now also possible to select backgrounds from Flickr accounts.</p></item>
     </list>
     <media type="image" src="figures/time-and-date.png"/>
@@ -63,7 +63,7 @@
 
   <section id="high-dpi">
     <title>High-Resolution Display Support</title>
-    <p>Screens with high resolutions (also known as high-density displays) are becoming increasingly common. 
GNOME 3.10 introduces support for these types of displays, and will now automatically scale what is displayed 
on the screen to compensate for increased display density. This ensures that controls and content appear at 
the correct size, and that interfaces are usable. This work could not have been possible without <link 
href="http://www.gnome.org/news/2013/07/gnome-receives-hardware-donations-to-assist-with-high-definition-support/";>the
 generous donation of high-density display laptops to the GNOME Foundation by Brion Vibber and 
Intel</link>.</p>
+    <p>High-resolution displays (also known as high-density displays) are becoming increasingly common. 
GNOME 3.10 introduces support for these types of displays, and will now automatically scale what is displayed 
on the screen to compensate for increased display density. This ensures that controls and content appear at 
the correct size, and that interfaces are usable. This work could not have been possible without <link 
href="http://www.gnome.org/news/2013/07/gnome-receives-hardware-donations-to-assist-with-high-definition-support/";>the
 generous donation of high-density display laptops to the GNOME Foundation by Brion Vibber and 
Intel</link>.</p>
     <media type="image" src="figures/placeholder.png"/>
   </section>
 
@@ -73,9 +73,9 @@
     <media type="image" src="figures/placeholder.png"/>
   </section>
 
-  <section id="magnifier-focus-caret-tracking">
-    <title>Magnifier's focus and caret tracking</title>
-    <p>Users of the magnifier can fully enjoy a rich magnification experience with the addition of new caret 
and focus tracking feature. With this new feature, the magnifier no longer tracks only the mouse but it can 
also track the focus the and the caret, so it becomes much easier to type and navigate using the keyboard 
whilst under the magnified view. For time constraints, it has not been possible to integrate, in this 
release, a proper user interface in the Universal Access settings to turn this feature on, so users need to 
use the DConf editor or the command line GSettings to turn it on.</p>
+  <section id="magnifier">
+    <title>Magnifier Focus and Caret Tracking</title>
+    <p>Users of the screen magnifier can fully enjoy a rich magnification experience with the addition of 
new caret and focus tracking. With this new feature, the magnifier no longer tracks only the mouse but can 
also track the focused interface widgets and the text input caret. This makes it much much easier to type and 
navigate using the keyboard while using the magnifier. For 3.10 it is necessary to use <app>DConf 
Editor</app> to turn this feature on. It will be added to the <gui>Universal Access</gui> settings in a 
future release.</p>
     <media type="image" src="figures/placeholder.png"/>
   </section>