[baobab/mallard-documentation] Scan-folder rewrite plus minor edits

[Michael Hill <mdhill src gnome org>]

commit 926b347815fdc438fe4aabf4f8c7c8fe778fc812
Author: Michael Hill <mdhill src gnome org>
Date:   Wed Dec 28 17:41:01 2011 -0500

    Scan-folder rewrite plus minor edits

 help/C/scan-filesystem.page |    9 +++---
 help/C/scan-folder.page     |   61 ++++++++++++++++++++++++++----------------
 help/C/scan-remote.page     |   48 ++++++++++++++++++++-------------
 3 files changed, 72 insertions(+), 46 deletions(-)
---
diff --git a/help/C/scan-filesystem.page b/help/C/scan-filesystem.page
index 5e4b268..7ce7850 100644
--- a/help/C/scan-filesystem.page
+++ b/help/C/scan-filesystem.page
@@ -27,8 +27,8 @@
     full file system.</p>
   </comment>
 
-  <p>You can check all the folders in your <file>Home</file> folder, 
-  on external devices and across your computer's file system by doing:</p>
+  <p>You can check all the folders in your <file>Home</file> folder, on external
+  devices and across your computer's filesystem using one of the following:</p>
 
   <list>
     <item><p>Select <guiseq><gui>Analyzer</gui><gui>Scan
@@ -60,8 +60,9 @@
   can also use the results to estimate how much space would be needed for a
   <link href="help:gnome-help/backup-how">backup</link> of your disk.</p>
 
-  <p>Right click on any folder and select <gui>Open Folder</gui> to browse all the folders inside, 
-  or <gui>Move to trash</gui> to move your folder to <file>Trash</file>.</p>
+  <p>Right-click on any folder and select <gui>Open Folder</gui> to browse all
+  the folders inside, or <gui>Move to trash</gui> to move your folder to
+  <file>Trash</file>.</p>
 
   <note style="advanced">
     <p><app>Disk Usage Analyzer</app> will display sizes in the directory tree
diff --git a/help/C/scan-folder.page b/help/C/scan-folder.page
index 1c7ff5b..dd1bfa6 100644
--- a/help/C/scan-folder.page
+++ b/help/C/scan-folder.page
@@ -9,44 +9,59 @@
       <email>yrazes gmail com</email>
       <years>2011</years>
     </credit>
+    <credit type="editor">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+    </credit>
 
-    <desc>Customize scanning in home folder, on external devices, on folder servers, and across your computer's file system.</desc>
+    <desc>Scan a specific folder.</desc>
 
   </info>
 
   <title>Scan a folder</title>
 
-  <comment><cite date="2011-12-19" href="mailto:yrazes gmail com">Julita Inca</cite>
+  <comment><cite date="2011-12-19" href="mailto:yrazes gmail com">Julita
+  Inca</cite>
   <p>This assumes the reader knows how to use the nautilus to browse folders. 
-  By the end of this page, the reader will be able to scan any folder inside your home, 
-  on external devices or across the computer.</p></comment>
+  By the end of this page, the reader will be able to scan any folder inside
+  your home, on external devices or across the computer.</p></comment>
+
+  <p>When reorganizing folders or preparing for a
+  <link href="help:gnome-help/backup-how">backup</link>, it is useful to have
+  disk space information for specific folders. To scan a folder:</p>
 
-  <p>If you have many folders inside one, and maybe you want to reorganize all the structure 
-  of this because it is too big or quite older; you probably need to found them to make your 
-  system run smoothly.</p>
+  <steps>
+    <item><p>Launch the command using one of the following:</p>
 
-  <p>You can scan a folder by doing one of these alternatives:</p>
+      <list>
+        <item><p>Select <guiseq><gui>Analyzer</gui><gui>Scan
+        Folder</gui></guiseq> from the menu.</p></item>
+        <item><p>Click <gui>Scan a folder</gui> in the toolbar.</p></item>
+        <item><p>Press <keyseq><key>CTRL</key><key>O</key></keyseq>.</p></item>
+      </list>
+    </item>
 
-  <list>
-     <item><p>Select <guiseq><gui>Analyzer</gui><gui>Scan Folder</gui></guiseq> from the menu.</p></item>
-     <item><p>Click <gui>Scan a folder</gui> in the toolbar.</p></item>
-     <item><p>Press <keyseq><key>CTRL</key><key>O</key></keyseq>.</p></item>
-  </list>
+    <item>
+      <p>Use the file browser to navigate and select the desired folder.</p>
+    </item>
+    <item><p>Click <gui>Open</gui>.</p></item>
+  </steps>
 
   <note style="tip">
-    <p>Click the <gui>Stop</gui> in the toolbar to cancel the current, or <gui>Refresh</gui> 
-    to repeat the  last scan.</p>
+    <p>Click the <gui>Stop</gui> in the toolbar to cancel the current scan, or
+    <gui>Refresh</gui> to repeat the  last scan.</p>
   </note> 
 
-  <p>The results may be useful in deciding which folders compress, which applications to uninstall, 
-  or which folders can be
+  <p>The results may be useful in deciding which applications to uninstall, or
+  which folders can be
+  <link href="ghelp:file-roller">archived</link>,
   <link href="help:gnome-help/files-delete">deleted</link> or
-  <link href="help:gnome-help/files-copy">moved</link>, to free up space on the
-  hard disk. You can also use them to estimate how much space would be needed
-  for a <link href="help:gnome-help/backup-how">backup</link> of your
-  <file>folder</file>.</p>
+  <link href="help:gnome-help/files-copy">moved</link>, to free up space. You
+  can also use the results to estimate how much space would be needed for a
+  <link href="help:gnome-help/backup-how">backup</link> of your disk.</p>
 
-  <p>Right click on any folder and select <gui>Open Folder</gui> to browse all the folders inside, 
-    or <gui>Move to trash</gui> to move your folder to <file>Trash</file>.</p>
+  <p>Right-click on any folder and select <gui>Open Folder</gui> to browse all
+  the folders inside, or <gui>Move to trash</gui> to move your folder to
+  <file>Trash</file>.</p>
 
 </page>
diff --git a/help/C/scan-remote.page b/help/C/scan-remote.page
index 9f3bb3c..e0e6924 100644
--- a/help/C/scan-remote.page
+++ b/help/C/scan-remote.page
@@ -27,9 +27,11 @@
   </comment>
 
   <p>You can use <app>baobab</app> to scan folders shared over a network.</p>
+
   <p>Maybe you are the admin of an intranet file server, and one day you notice
-  that nobody in the company can save files to it because the disks are completely full.
-  In this case, it is useful to be able to scan remotely from another computer. </p>
+  that nobody in the company can save files to it because the disks are
+  completely full. In this case, it is useful to be able to scan remotely from
+  another computer. </p>
 
   <p>To start scanning, select <guiseq><gui>Analyzer</gui><gui>Scan Remote
   Folder</gui></guiseq> from the menu, or click <gui>Scan a remote folder</gui>
@@ -37,31 +39,34 @@
 
   <p>Scanning over a network may be slow.</p>
 
-  <p>Right click on any folder and select <gui>Open Folder</gui> to browse all the folders inside, 
-   or <gui>Move to trash</gui> to move your folder to <file>Trash</file>.</p>
+  <p>Right-click on any folder and select <gui>Open Folder</gui> to browse all
+  the folders inside, or <gui>Move to trash</gui> to move your folder to
+  <file>Trash</file>.</p>
   
   <p>Choose one of following protocols:</p>
 
   <list>
-    <item><p><link xref="ssh">SSH</link> (Secure Shell) is a
-    protocol which lets you access other folders from another computer over the network. 
-    It uses a secure remote login because it is not possible to discover users and passwords.</p></item>
+    <item><p><link xref="ssh">SSH</link> (Secure Shell) is a protocol which lets
+    you access other folders from another computer over the network. It uses a
+    secure remote login because it is not possible to discover users and
+    passwords.</p></item>
 
-    <item><p><link xref="ftp">FTP (with login)</link> (File Transfer Protocol) with login, 
-    lets you share and transfer folders reliably and efficiently from remote computers.
-    In this case a user account is required.</p></item>
+    <item><p><link xref="ftp">FTP (with login)</link> (File Transfer Protocol)
+    with login, lets you share and transfer folders reliably and efficiently
+    from remote computers. In this case a user account is required.</p></item>
 
-    <item><p><link xref="ftp">Public FTP</link> lets you share files without the need
-    to log in with a user name and password. The server creates an anonymous
-    user to make the connection.</p></item>
+    <item><p><link xref="ftp">Public FTP</link> lets you share files without the
+    need to log in with a user name and password. The server creates an
+    anonymous user to make the connection.</p></item>
 
-    <item><p><link xref="windows-share">Windows Share</link> lets you view and manage
-    folders used in your Windows network. You can do Windows shares from a Linux machine.</p></item>
+    <item><p><link xref="windows-share">Windows Share</link> lets you view and
+    manage folders used in your Windows network. You can do Windows shares from
+    a Linux machine.</p></item>
 
-    <item><p><link xref="web-dav">WebDAV (HTTP)</link> (Web-based Distributed Authoring and
-    Versioning methods of Hypertext Transfer Protocol HTTP) lets you collaborate with other
-    users in editing and managing documents over the network. These folders are stored on 
-    World Wide Web servers.</p></item>
+    <item><p><link xref="web-dav">WebDAV (HTTP)</link> (Web-based Distributed
+    Authoring and Versioning methods of Hypertext Transfer Protocol HTTP) lets
+    you collaborate with other users in editing and managing documents over the
+    network. These folders are stored on World Wide Web servers.</p></item>
 
     <item><p><link xref="web-dav">Secure WebDAV (HTTPS)</link>: Secure WebDAV
     ensures encryption of transfered data (WebDAV over HTTPS will be
@@ -71,4 +76,9 @@
     to access a particular function from the folder manager.</p></item>
   </list>
 
+  <comment>
+    <cite date="2011-12-28" href="mailto:mdhillca gmail com">Michael Hill</cite>
+    <p>Custom Location needs a better explanation.</p>
+  </comment>
+
 </page>