Update to gosoverview.xml

[Phil Bull <philbull gmail com>]

Hi guys,

I've attached a patch to
gnome-user-docs/trunk/gnome2-user-guide/C/gosoverview.xml. The section
was reviewed using the GNOME 2.24 VMware Live Demo [1], and the
following changes have been made:

      * Added markup to key combos which lacked it
      * Several small changes to wording, for clarity
      * Updated text referring to changed menu locations and labels
      * Several spelling, grammar and capitalisation fixes
      * Removed technical wording (references to Motif etc) and
        excessive detail in "Common Features"
      * Added new section to document the "New Folder" option in the
        Save dialog

The document should be fully up-to-date (for GNOME 2.24) with these
changes applied.

Thanks,

Phil

[1] - http://torrent.gnome.org/

-- 
Phil Bull
https://launchpad.net/people/philbull

Index: gosoverview.xml
===================================================================
--- gosoverview.xml	(revision 1041)
+++ gosoverview.xml	(working copy)
@@ -91,11 +91,12 @@
     <varlistentry>
       <term>Control Center</term>
       <listitem><para>You can customize your computer using the 
-      <application>Control Center</application>. Each preference tool in the 
-      Control allows you to change
-      a particular part of the behavior of your computer. The Control Center
-      can be found in the <guimenu>System</guimenu> menu on the panel menubar.
-      See <xref linkend="prefs"/> for more information on the Control Center.</para></listitem>
+      <application>Control Center</application>, which can be found in the 
+      <guimenu>System</guimenu> menu on the top panel menubar. 
+      Each preference tool in the Control Center allows you to change
+      a particular part of the behavior of your computer. See 
+      <xref linkend="prefs"/> for more information on the 
+      Control Center.</para></listitem>
     </varlistentry>
   </variablelist>
 
@@ -115,7 +116,7 @@
 	    <listitem><para>The <interface>Computer</interface> icon gives you access to CDs, removable media such as floppy disks, and also the entire filesystem (also known as the root filesystem). By default, you do not have the security permissions to read other users' files or edit system files, but you may need to do so something such as configure a web server on the computer.</para></listitem>
 	    <listitem><para>Your Home Folder, labelled <interface><replaceable>username</replaceable>'s Home</interface><!-- translators, change this example as required for your locale -->, where all of your personal files are kept. You can also open this folder from the <guimenu>Places</guimenu> menu.</para></listitem>
 	    <listitem><para>The <interface>Trash</interface> is a special folder in which to place files and folders you no longer need. For more on this, see <xref linkend="nautilus-trash"/>.</para></listitem>
-	    <listitem><para>When you insert a CD, a flashdrive, or other removable media, or a device containing files such as a music player or a digital camera, an icon representing this device will appear on the desktop.</para></listitem>
+	    <listitem><para>When you insert a CD, a flash drive, or other removable media, or a device containing files such as a music player or a digital camera, an icon representing this device will appear on the desktop.</para></listitem>
     </itemizedlist>
     
     <para>As you work with your computer, the desktop becomes obscured by the windows you are working with. To quickly reveal the desktop by minimizing all windows, you can do one of the following:</para>
@@ -129,7 +130,7 @@
     
     <para>You can change the colour of the desktop background or the image displayed there. For more on this, see <xref linkend="prefs-desktopbackground"/>.</para>
 
-    <note><para>The files and folders you put on the desktop are stored in a special folder within your Home Folder, called <filename>Desktop</filename>. Like any other folder, you can put files (and other folders) directly into it, they will just also happen to show up on desktop itself.</para></note>
+    <note><para>The files and folders you put on the desktop are stored in a special folder within your Home Folder, called <filename>Desktop</filename>. Like any other folder, you can put files and other folders directly into it. The only difference is that anything placed into the Desktop folder will then show up on desktop itself.</para></note>
   
 </section>
 
@@ -150,7 +151,7 @@
   
   <para>Each window is not necessarily a different application. An application usually has one main window, and may open additional windows at the request of the user.</para>
 
-  <para>The rest of this section describe the different types of windows and how you
+  <para>The rest of this section describes the different types of windows and how you
   can interact with them.</para>
 
   <section id="windows-types">
@@ -180,7 +181,7 @@
             
             <para>Some dialogs do not allow you to interact with the main application window until you have closed them: these are called <firstterm>modal</firstterm> dialogs. Others can be left open while you work with the main application window: these are called <firstterm>transient</firstterm> dialogs.</para>
             
-            <tip><para>You can select the text in a dialog with the mouse. This allows you to copy it to the clipboard (CTRL-C to copy), and paste it into another application. You may wish to quote the text you see in a dialog when requesting support on the Internet.</para></tip>
+            <tip><para>You can select the text in a dialog with the mouse. This allows you to copy it to the clipboard (by right-clicking the text and selecting <guilabel>Copy</guilabel>), and paste it into another application. This is useful if you wish to quote the text you see in a dialog when requesting support on the Internet.</para></tip>
         </listitem>
       </varlistentry>
     </variablelist>
@@ -193,12 +194,12 @@
     <!-- Maintained for 2.8 compatibility -->
     <anchor id="gosoverview-32"/>
 
-    <para>You can change the size and position of windows on the screen. This allows you to see more than one application and do different tasks at the same time. For example, you might want to read text on a web page and write with a word processor; or simple change to another application to do a different task or see the progress.</para> 
+    <para>You can change the size and position of windows on the screen. This allows you to see more than one application and do different tasks at the same time. For example, you might want to read text on a web page while writing with a word processor, or to change to another application to do a different task or check its progress.</para> 
     
     <para>You can <firstterm>minimize</firstterm> a window if you are not currently interested in seeing it. This hides it from view. You can <firstterm>maximise</firstterm> a window to fill the whole screen so you can give it your full attention.</para> 
     
     <para><anchor id="gosoverview-FIG-33"/>Most of these actions are carried out by using the mouse on different parts of the the window's frame (see <xref linkend="mouse-actions"/> for a recap of using the mouse). The top edge of the window frame, called the <firstterm>titlebar</firstterm> because it also displays the title of the window, contains several buttons that change the way the window is displayed.</para>
-    <para><xref linkend="fig-titlebar-anno-window"/> shows the titlebar for a typical application window. From left to right, this contains the window menu button, the window title, the minimize button, the maximize button, and the close button.</para>
+    <para><xref linkend="fig-titlebar-anno-window"/> shows the titlebar for a typical application window. From left to right, this contains the Window Menu button, the window title, the minimize button, the maximize button, and the close button.</para>
     
     <figure id="fig-titlebar-anno-window">
       <title>Titlebar for a Typical Application Window</title>
@@ -214,7 +215,7 @@
       </screenshot>
     </figure>
 
-    <para>All actions can also be carried out from the Window Menu. To open this, click on the Window Menu Button at the left-hand edge of the titlebar. Common actions can also be carried out with keyboard shortcuts: see <xref linkend="shortcuts-window"/> for a simple list of these. The following lists the actions you can carry out on a window, with the mouse or the keyboard:</para>
+    <para>All actions can also be carried out from the Window Menu. To open this, click on the Window Menu button at the left-hand edge of the titlebar. Common actions can also be carried out with keyboard shortcuts: see <xref linkend="shortcuts-window"/> for a simple list of these. The following lists the actions you can carry out on a window, with the mouse or the keyboard:</para>
 
    <variablelist>
       <varlistentry>
@@ -282,7 +283,7 @@
       <varlistentry>
         <term>Close the window</term>
         <listitem>
-            <para>Click the Close button, the rightmost of the group of three on the right. This could close the application too. The application will ask you to confirm closing a window that contains unsaved work.</para>
+            <para>Click the Close button, the rightmost of the group of three on the right. Closing the window may also close the application itself. The application will ask you to confirm closing a window that contains unsaved work.</para>
         </listitem>
       </varlistentry>                        
     </variablelist> 
@@ -318,7 +319,7 @@
           </listitem>    
         <listitem>
           <para>
-          With the keyboard, hold the [Alt] key and press the [Tab] key. A pop-up window appears with a list of icons representing each window. While still holding [Alt], press [Tab] to move the selection along the list: a black rectangle frames the selected icon and the position of the window it corresponds to is highlighted with a black border. When the window you want to see is selected, release the [Alt] key. Using [Shift+Tab] instead of just [Tab] cycles through the icons in reverse order.      
+          With the keyboard, hold the <keycap>Alt</keycap> key and press the <keycap>Tab</keycap> key. A pop-up window appears with a list of icons representing each window. While still holding <keycap>Alt</keycap>, press <keycap>Tab</keycap> to move the selection along the list: a black rectangle frames the selected icon and the position of the window it corresponds to is highlighted with a black border. When the window you want to see is selected, release the <keycap>Alt</keycap> key. Using <keycombo><keycap>Shift</keycap><keycap>Tab</keycap></keycombo> instead of just <keycap>Tab</keycap> cycles through the icons in reverse order.      
           </para>
           <note><para>
             You can customize the shortcut used to perform this action with the <link linkend="prefs-keyboard-shortcuts">Keyboard Shortcuts preference tool</link>.
@@ -420,12 +421,12 @@
       <listitem><para><ulink type="help" url="ghelp:gnome-dictionary"><application>Dictionary</application></ulink> allows you to look up definitions of a word. </para></listitem>
       <listitem><para><ulink type="help" url="ghelp:eog"><application>Image Viewer</application></ulink> can display single image files, as well as large image collections.</para></listitem>
       <listitem><para><ulink type="help" url="ghelp:gcalctool"><application>Calculator</application></ulink> performs basic, financial, and scientific calculations.</para></listitem>
-      <listitem><para><ulink type="help" url="ghelp:gucharmap"><application>Character Map</application></ulink> lets you choose letters and symbols from the <firstterm>Unicode</firstterm> character set and paste them into any application. If you are writing in several languages, not all the characters you need will be on your keyboard.</para></listitem>
-      <listitem><para><link linkend="nautilus"><application>Nautilus File Manager</application></link> displays your folders and their contents. Use this to copy, move, classify your files; and access CDs, USB flashdrives, or any removable media. When you choose an item from the <link linkend="places-menu"><guimenu>Places</guimenu> menu</link>, a <application>Nautilus File Manager</application> window opens you show you that location.</para></listitem>
+      <listitem><para><ulink type="help" url="ghelp:gucharmap"><application>Character Map</application></ulink> lets you choose letters and symbols from the <firstterm>Unicode</firstterm> character set and paste them into any application. If you are writing in several languages, not all of the characters you need will be on your keyboard.</para></listitem>
+      <listitem><para><link linkend="nautilus"><application>Nautilus File Manager</application></link> displays your folders and their contents. Use this to copy, move and classify your files, and to access CDs, USB flash drives, and any other removable media. When you choose an item from the <link linkend="places-menu"><guimenu>Places</guimenu> menu</link>, a <application>Nautilus File Manager</application> window opens showing that location.</para></listitem>
       <listitem><para><ulink type="help" url="ghelp:gnome-terminal"><application>Terminal</application></ulink> gives you access to the system command line.</para></listitem>
     </itemizedlist>
 
-    <para>Further standard GNOME applications include games, music and video players, a web browser, software accessibility tools, and utilities to manage your system. Your distributor or vendor may have added other GNOME applications, such as a word processor and a graphics editor. Your distributor or vendor may also provide you with a way to install further applications.</para>
+    <para>Further standard GNOME applications include games, music and video players, a web browser, software accessibility tools, and utilities to manage your system. Your distributor or vendor may have added other applications, such as a word processor and a graphics editor. They may also provide you with a way to install further applications.</para>
     
     <para>All GNOME applications have many features in common, which makes it easier to learn how to work with a new GNOME application. The rest of this section describes some of these features.</para>
 
@@ -433,52 +434,31 @@
       <title>Common Features</title>
     
       <para>The applications that are provided with the GNOME Desktop
-  share several characteristics. For example, the applications have a consistent
-  look-and-feel. The applications share characteristics because the applications
-  use the same programming libraries. An application that uses the standard
-  GNOME programming libraries is called a <firstterm>GNOME-compliant application</firstterm>. For example, <application>Nautilus</application> and the <application>gedit</application> text editor are GNOME-compliant applications.</para>
-      <para>GNOME provides libraries in addition to the libraries provided by your
-  operating system. The libraries enable GNOME to run your existing applications
-  as well as GNOME-compliant applications. For example, if your operating system
-  is UNIX-based, you can run your current X11 applications and Motif applications
-  from the GNOME Desktop.</para>
+  share many common features, such as similar open and save dialogs and similar-looking icons. This is because they have all been developed using the GNOME development platform. An application developed using this platform is called a <firstterm>GNOME-compliant application</firstterm>. For example, <application>Nautilus</application> and the <application>gedit</application> text editor are GNOME-compliant applications.</para>
       <para>Some of the features of GNOME-compliant applications are as follows:</para>
       <itemizedlist>
         <listitem>
           <para>Consistent look-and-feel</para>
-          <para>GNOME-compliant applications have a consistent look-and-feel. GNOME-compliant
-  applications use the look-and-feel settings that you specify in the preference
-  tools. You can use the following tools to change the look-and-feel of your
-  GNOME-compliant applications:</para>
-          <itemizedlist>
-            <listitem><para><link linkend="prefs-menustoolbars"><application>Menus &amp; Toolbars</application> preference tool</link></para></listitem>
-            <listitem><para><link linkend="prefs-theme"><application>Theme</application> preference tool</link></para></listitem>
-          </itemizedlist>
+          <para>GNOME-compliant applications have a consistent look-and-feel. You can use the <link linkend="prefs-theme"><application>Appearance</application> preference tool</link> to change the look-and-feel of your GNOME-compliant applications.</para>
         </listitem>
         <listitem>
           <para>Menubars, toolbars, and statusbars</para>
           <para>Most GNOME-compliant applications have a menubar, a toolbar, and a statusbar.
-  The menubar always contains a <guimenu>File</guimenu> menu and a <guimenu>Help</guimenu> menu. The <guimenu>File</guimenu> menu always contains a <guimenuitem>Quit</guimenuitem> menu item, and the <guimenu>Help</guimenu> menu always
+  The menubars usually have a similar structure; for example, the <guimenu>Help</guimenu> menu always
   contains an <guimenuitem>About</guimenuitem> menu item.</para>
           <para>A <firstterm>toolbar</firstterm> is a bar that appears under the menubar.
-  A toolbar contains buttons for the most commonly-used commands. A <firstterm>statusbar</firstterm> is a bar at the bottom of a window that provides information
-  about the current state of what you are viewing in the window. GNOME-compliant
-  applications might also contains other bars. For example, <application>Nautilus</application> contains a location bar.</para>
-          <para>You can choose to make the toolbars in GNOME-compliant applications <firstterm>detachable</firstterm>. That
-  is, the toolbar can be removed from within the window and placed anywhere on the screen. When this option is enabled, each toolbar has a handle that you can grab then drag the bar to another location.  You can drag the bar to snap to another side of the window, or to another part of the screen.</para>
+  A toolbar contains buttons for the most commonly-used commands. A <firstterm>statusbar</firstterm> is a bar at the bottom of a window that provides information about the current state of what you are viewing in the window. Applications might also contains other bars. For example, <application>Nautilus</application> contains a location bar.</para>
         </listitem>
         <listitem>
           <para>Default shortcut keys</para>
           <para>GNOME-compliant applications use the same shortcut keys to perform the
-  same actions. For example, to quit a GNOME-compliant application, press <keycombo><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo>. To undo an action in a GNOME-compliant
-  application, press <keycombo><keycap>Ctrl</keycap><keycap>Z</keycap></keycombo>. </para>
+  same actions. See <xref linkend="keyboard-skills"/> for a list of common shortcut keys.</para>
         </listitem>
         <listitem>
           <para>Drag-and-drop</para>
-          <para>GNOME-compliant applications provide consistent feedback
-  when you drag-and-drop items, and interoperate in a sophisticated manner.</para>
-          <para>For example, GNOME-compliant applications
-  recognize the format of the items that you drag. When you drag a HTML file
+          <para>When you drag-and-drop something into a GNOME-compliant application, 
+          it will recognize the format of the items that you dragged and will handle 
+          them in an appropriate manner. For example, when you drag a HTML file
   from a <application>Nautilus</application> window to a web browser, the file
   is displayed in HTML format in the browser. However, when you drag the HTML
   file to a text editor, the file is displayed in plain text format in the text
@@ -488,7 +468,7 @@
     </section>
     <section id="overview-files">
       <title>Working With Files</title>
-      <para>The work you do with an application is stored in <firstterm>files</firstterm>. These may be on your computer's hard drive, or on a removable device such as a USB flashdrive. You <firstterm>open</firstterm>  a file to examine it or work on it, and you <firstterm>save</firstterm> a file to store your work. When you are done working with a file, you <firstterm>close</firstterm> it.</para>
+      <para>The work you do with an application is stored in <firstterm>files</firstterm>. These may be on your computer's hard drive, or on a removable device such as a USB flash drive. You <firstterm>open</firstterm>  a file to examine it or work on it, and you <firstterm>save</firstterm> a file to store your work. When you are done working with a file, you <firstterm>close</firstterm> it.</para>
       <para>All GNOME applications use the same dialogs for opening and saving files, presenting you with a consistent interface. The following sections cover the open and the save dialog in detail.</para>
     </section>
     <section id="filechooser-open">
@@ -507,7 +487,7 @@
       <para>To change the location shown in the right-hand pane, do one of the following:</para>
       <itemizedlist>
 	      <listitem><para>Open a folder that is listed in the current location.</para></listitem>
-	      <listitem><para>Open an item in the left-hand pane. This pane lists places such as your Documents folder, your Home Folder, media such as CDs and flashdrives, places on your network, and your <link linkend="nautilus-bookmarks">bookmarks</link>.</para></listitem>
+	      <listitem><para>Open an item in the left-hand pane. This pane lists places such as your Documents folder, your Home Folder, media such as CDs and flash drives, places on your network, and your <link linkend="nautilus-bookmarks">bookmarks</link>.</para></listitem>
 	      <listitem><para>Click one of the buttons in the path bar above the file listing pane. This shows the hierarchy of folders that contain your current location. Use the arrow buttons to either side of the button bar if the list of folders is too long to fit.</para></listitem>
       </itemizedlist>
       
@@ -515,7 +495,7 @@
               
       <section id="filechooser-open-filter">
         <title>Filtering the File List</title>
-        <para>You can restrict the file list to show only files on certain types. To do this, choose a file type from the drop-down list beneath the file list pane. The list of file types depends on the application you are currently using. For example, a graphics application will list different image file formats, and a text editor will list different types of text file.</para>
+        <para>You can restrict the file list to show only files of certain types. To do this, choose a file type from the drop-down list beneath the file list pane. The list of file types depends on the application you are currently using. For example, a graphics application will list different image file formats, and a text editor will list different types of text file.</para>
       </section>
       
       <section id="filechooser-open-find">
@@ -531,7 +511,7 @@
            
       <section id="filechooser-open-location">
         <title>Open Location</title>
-        <para>You can type a full or relative path to the file you want to open. Begin typing a full path starting with <filename>/</filename> to open the <guilabel>Open Location</guilabel> dialog. Otherwise, to open the <guilabel>Open Location</guilabel> dialog either press <keycombo><keycap>Ctrl</keycap><keycap>L</keycap></keycombo> or right-click in the right-hand pane and choose <guimenuitem>Open Location</guimenuitem>.</para>
+        <para>You can type a full or relative path to the file you want to open. Press <keycombo><keycap>Ctrl</keycap><keycap>L</keycap></keycombo> or click the button at the top left of the window to show (or hide) the <guilabel>Location</guilabel> field. Alternatively, begin typing a full path starting with <filename>/</filename> to show the <guilabel>Location</guilabel> field.</para>
         <para>Type a path from the current location, or an absolute path beginning with <filename>/</filename> or <filename>~/</filename>. The <guilabel>Location</guilabel> field has the following features to simplify the typing of a full filename:</para>
         <itemizedlist>
 	        <listitem><para>A drop-down of possible file and folder names is displayed once you begin typing. Use <keycap>down arrow</keycap> and <keycap>up arrow</keycap> and <keycap>Return</keycap> to choose from the list.</para></listitem>
@@ -541,7 +521,7 @@
       
       <section id="filechooser-open-remote">
         <title>Opening Remote Locations</title>
-        <para>You can open files in remote locations by choosing the location from the left panel, or by typing a path to a remote location into the <guilabel>Open Location</guilabel> dialog.</para>
+        <para>You can open files in remote locations by choosing the location from the left panel, or by typing a path to a remote location into the <guilabel>Location</guilabel> field.</para>
         <para>If you require a password to access the remote location, you will be asked for it when you open it.</para>
       </section> 
                    
@@ -558,7 +538,7 @@
     </section>
     <section id="filechooser-save">
       <title>Saving a File</title>
-        <para>The first time you save your work in an application, the <guilabel>Save File</guilabel> dialog will ask you for a location and name for the new file. Subsequent saving updates this file. To save to a new file, choose <menuchoice><guimenu>File</guimenu><guimenuitem>Save As</guimenuitem></menuchoice>.</para>
+        <para>The first time you save your work in an application, the <guilabel>Save As</guilabel> dialog will ask you for a location and name for the new file. When you save the file on subsequent occasions it will be updated immediately and you will not be asked to re-enter a location or name for the file. To save to a new file, choose <menuchoice><guimenu>File</guimenu><guimenuitem>Save As</guimenuitem></menuchoice>.</para>
         <para>You can enter a filename and choose a location to save in from the drop-down list of bookmarks and commonly-used locations.</para>
                           
         <section id="filechooser-save-expanded">
@@ -575,7 +555,12 @@
         <section id="filechooser-save-path">
           <title>Typing a Path</title>
           <para>To specify a path to save a file, type it into the <guilabel>Name</guilabel> field. A drop-down of possible file and folder names is displayed once you begin typing. Use <keycap>down arrow</keycap> and <keycap>up arrow</keycap> and <keycap>Return</keycap> to choose from the list. If only one file or folder matches the partial name you have typed, press <keycap>Tab</keycap> to complete the name.</para>       
-        </section>  
+        </section>
+        
+        <section id="filechooser-save-newfolder">
+          <title>Creating a New Folder</title>
+          <para>If you would like to create a new folder to save your file in, press the <guibutton>Create Folder</guibutton> button. Type a name for the new folder and press <keycap>Return</keycap>. You can then choose to save your file in the new folder, as you would with any other folder.</para>
+        </section>
     </section>
   </section>
 </chapter>