[gnome-user-docs/gnome-3-0] Review edits to files- pages

[Phil Bull <philbull src gnome org>]

commit 6663ea14f03c5979ceba4d45ff261d73cd901477
Author: Phil Bull <philbull gmail com>
Date:   Mon Jun 6 17:25:23 2011 +0100

    Review edits to files- pages

 gnome-help/C/files-browse.page |    6 ++++-
 gnome-help/C/files-copy.page   |   48 ++++++++++++++++++++-------------------
 2 files changed, 30 insertions(+), 24 deletions(-)
---
diff --git a/gnome-help/C/files-browse.page b/gnome-help/C/files-browse.page
index 15a2099..9326573 100644
--- a/gnome-help/C/files-browse.page
+++ b/gnome-help/C/files-browse.page
@@ -8,7 +8,7 @@
     <desc>Manage and organize files with the file manager.</desc>
 
     <revision pkgversion="3.0" date="2011-03-29" status="final"/>
-    <revision pkgversion="3.0" version="3.0.1" date="2011-04-06" status="outdated"/>
+    <revision pkgversion="3.0" version="3.0.1" date="2011-06-06" status="incomplete"/>
     <credit type="author">
       <name>Tiffany Antopolski</name>
       <email>tiffany antopolski gmail com</email>
@@ -58,4 +58,8 @@ to enable the tree sidebar. Click the expander next to a folder to
 show its child folders in the tree, or click a folder to open it
 in the window.</p>
 
+<comment>
+	<p>This page is a feature overview. It should be split into sections, with one feature per section. Small illustrative figures should be used to display these features where appropriate. A better explanation for the path bar is required (shouldn't be talking about the "root" of anything, that's a technical term.) Explain how you can add things to the sidebar (link to a topic or explain it here).</p>
+</comment>
+
 </page>
diff --git a/gnome-help/C/files-copy.page b/gnome-help/C/files-copy.page
index 2a8f1b2..268fce9 100644
--- a/gnome-help/C/files-copy.page
+++ b/gnome-help/C/files-copy.page
@@ -7,7 +7,7 @@
     <desc>Copy or move items to a new directory.</desc>
 
     <revision pkgversion="3.0" date="2011-03-29" status="final"/>
-    <revision pkgversion="3.0" version="3.0.1" date="2011-04-06" status="outdated"/>
+    <revision pkgversion="3.0" version="3.0.1" date="2011-06-06" status="review"/>
     <credit type="author">
       <name>Cristopher Thomas</name>
       <email>crisnoh gmail com</email>
@@ -25,40 +25,42 @@
 A file or folder can be copied or moved to a new location by dragging and dropping with the mouse, using the copy and paste commands, or by using keyboard shortcuts.
 </p>
 <p>
-As an example, copying files can be useful when creating a folder which contains files to email to a friend or coworker, or when <link xref="files#backup">backing up</link> individual files to an external disk.
-</p>
-
-<steps>
-<title>Drag files to copy or move</title>
-<item><p><link xref="files-browse">Open the file manager</link> to the folder containing the item you want to copy.</p></item>
-<item><p>Click <guiseq><gui>File</gui><gui>New Window</gui></guiseq> (or press <keyseq><key>Ctrl</key><key>N</key></keyseq>) to open a second window. Navigate to the folder where you want to move or copy the item in the new window.</p></item>
-<item><p>Click and drag the item from one window to another. By default, dragging an item will <em>move it</em> if the destination is on the same device (i.e. if both folders are on the same hard disk on your computer).</p>
-  <p>Dragging will <em>copy it</em> if the destination is on a difference device, such as a USB storage device, however. You can override this:</p>
-<list style="compact">
-<item><p>To force the file to be copied, hold down the <key>Ctrl</key> key while dragging.</p></item>
-<item><p>To force the file to be moved, hold down the <key>Shift</key> key while dragging.</p></item>
-</list></item>
-</steps>
+For example, you might want to copy a presentation onto a memory stick so you can take it to work with you. Or, you could make a back-up copy of a document before you make changes to it (and then use the old copy if you don't like your changes).</p>
 
 <steps>
 <title>Copy and paste files</title>
-<item><p>Select the item you want to copy by clicking on it once.</p></item>
+<item><p>Select the file you want to copy by clicking on it once.</p></item>
 <item><p>Click <guiseq><gui>Edit</gui><gui>Copy</gui></guiseq>, or press <keyseq><key>Ctrl</key><key>C</key></keyseq>.</p></item>
-<item><p>Navigate to another folder, where you want to put the copy of the item.</p></item>
-<item><p>Click <guiseq><gui>Edit</gui><gui>Paste</gui></guiseq> to finish copying the item, or press <keyseq><key>Ctrl</key><key>V</key></keyseq>. There will now be a copy of the file in the original folder and the other folder.</p></item>
+<item><p>Navigate to another folder, where you want to put the copy of the file.</p></item>
+<item><p>Click <guiseq><gui>Edit</gui><gui>Paste</gui></guiseq> to finish copying the file, or press <keyseq><key>Ctrl</key><key>V</key></keyseq>. There will now be a copy of the file in the original folder and the other folder.</p></item>
 </steps>
 
 <steps>
-<title>Cut and paste files (to move them)</title>
-<item><p>Select the item you want to move by clicking on it once.</p></item>
+<title>Cut and paste files to move them</title>
+<item><p>Select the file you want to move by clicking on it once.</p></item>
 <item><p>Click <guiseq><gui>Edit</gui><gui>Cut</gui></guiseq>, or press <keyseq><key>Ctrl</key><key>X</key></keyseq>.</p></item>
-<item><p>Navigate to another folder, where you want to move the item.</p></item>
-<item><p>Click <guiseq><gui>Edit</gui><gui>Paste</gui></guiseq> to finish moving the item, or press <keyseq><key>Ctrl</key><key>V</key></keyseq>. The file will be taken out of its original folder and moved to the other folder.</p></item>
-</steps> 
+<item><p>Navigate to another folder, where you want to move the file.</p></item>
+<item><p>Click <guiseq><gui>Edit</gui><gui>Paste</gui></guiseq> to finish moving the file, or press <keyseq><key>Ctrl</key><key>V</key></keyseq>. The file will be taken out of its original folder and moved to the other folder.</p></item>
+</steps>
+
+<steps>
+<title>Drag files to copy or move</title>
+<item><p>Open the file manager and go to the folder which contains the file you want to copy.</p></item>
+<item><p>Click <guiseq><gui>File</gui><gui>New Window</gui></guiseq> (or press <keyseq><key>Ctrl</key><key>N</key></keyseq>) to open a second window. In the new window, navigate to the folder where you want to move or copy the file.</p></item>
+<item>
+ <p>Click and drag the file from one window to another. This will <em>move it</em> if the destination is on the <em>same</em> device, or <em>copy it</em> if the destination is on a <em>different</em> device.</p>
+ <p>For example, if you drag a file from a USB memory stick to your Home folder, it will be copied, because you're dragging from one device to another.</p>
+ <p>You can force the file to be copied by holding down the <key>Ctrl</key> key while dragging, or force it to be moved by holding down the <key>Shift</key> key while dragging.</p>
+ </item>
+</steps>
 
 <note>
  <title>Why can't I copy/move a file?</title>
  <p>You can't copy or move a file into a folder that is <em>read-only</em>. Some folders are read-only to prevent you from making changes to their contents. You can change things from being read-only by <link xref="nautilus-file-properties-permissions">changing file permissions</link>.</p>
 </note>
 
+<comment>
+ <p>This topic would be ideal for expanding sections. All of the sections would be collapsed by default, so the topic would look sparse, but then the reader could expand the section reflecting their preferred choice of interaction.</p>
+</comment>
+
 </page>