[baobab/mallard-documentation: 11/27] Review of user help



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

    Review of user help

 help/C/allocated-space.page |   21 +++++++++-----
 help/C/custom-location.page |   19 +++++++++----
 help/C/ftp.page             |   35 +++++++++++++++++--------
 help/C/multi-core.page      |   29 ++++++++++++--------
 help/C/no-come-up.page      |   18 ++++++++----
 help/C/scan-filesystem.page |   11 ++++---
 help/C/scan-folder.page     |   61 ++++++++++++++++++++++++++----------------
 help/C/scan-home.page       |    2 +-
 help/C/scan-remote.page     |   48 ++++++++++++++++++++-------------
 help/C/ssh.page             |   36 +++++++++++++++++--------
 help/C/view-rings.page      |   40 ++++++++++++++++------------
 help/C/view-tree.page       |   32 ----------------------
 help/C/virtual-folders.page |   26 ++++++++++++------
 help/C/web-dav.page         |   44 ++++++++++++++++++++++---------
 help/C/windows-share.page   |   31 +++++++++++++++------
 15 files changed, 271 insertions(+), 182 deletions(-)
---
diff --git a/help/C/allocated-space.page b/help/C/allocated-space.page
index 14ad421..d6de4f2 100644
--- a/help/C/allocated-space.page
+++ b/help/C/allocated-space.page
@@ -9,24 +9,29 @@
       <email>yrazes gmail com</email>
       <years>2011</years>
     </credit>
+    <credit type="editor">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+    </credit>
 
-    <desc>Scanning results display each directory and not the folder size. If you want to view the folder size, uncheck this option</desc>
+    <desc>To view the apparent folder size, uncheck this option</desc>
    </info>
 
    <title>Allocated space</title>
 
    <comment><cite date="2011-12-19" href="mailto:yrazes gmail com">Julita Inca</cite>
-   <p>This assumes the reader knows how to scan any particular folder. 
-      By the end of this page, the user can read the results. 
-      The percentage of usage and capacity showed in a rectangle form grouped like tree.</p></comment>
+   <p>This assumes the reader knows how to scan any particular folder. By the
+   end of this page, the user can read the results. The percentage of usage and
+   capacity showed in a rectangle form grouped like tree.</p></comment>
 
-   <p><app>Disk Usage Analyzer</app> will display sizes in the directory tree as allocated space. 
-   This means that the displayed sizes refer to the actual disk usage and not to the apparent directory size.</p>
+   <p><app>Disk Usage Analyzer</app> will display sizes in the directory tree as
+   allocated space. This means that the displayed sizes refer to the actual
+   disk usage and not to the apparent directory size.</p>
 
-   <p>If you want to view the apparent file size:</p>
+   <p>To view the apparent file size:</p>
    
    <steps>
-      <item><p>Click <guiseq><gui>View</gui><gui>Allocated Space</gui></guiseq> and disable or enable it, depends on your preferences.</p></item>
+      <item><p>Click <gui>View</gui> and deselect <gui>Allocated Space</gui>.</p></item>
    </steps>
 
 </page>
diff --git a/help/C/custom-location.page b/help/C/custom-location.page
index 6997ad1..8219686 100644
--- a/help/C/custom-location.page
+++ b/help/C/custom-location.page
@@ -9,18 +9,25 @@
       <email>yrazes gmail com</email>
       <years>2011</years>
     </credit>
+    <credit type="editor">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+    </credit>
 
-    <desc>Custom Location</desc>
+    <desc>Scanning a remote file system using Custom Location.</desc>
   </info>
 
   <title>Custom Location</title>
 
   <comment><cite date="2011-12-19" href="mailto:yrazes gmail com">Julita Inca</cite>
-  <p>This assumes the reader knows there are many forms to establish connection remotely to scan folders.</p></comment>
+  <p>This assumes the reader knows there are many forms to establish connection
+  remotely to scan folders.</p></comment>
+
+  <p>To scan remotely using <gui>Custom Location</gui> as the
+  <gui>Service type</gui>:</p>
 
-  <p>If you selected <gui>Custom Location</gui> as a Service type:</p>
-  <p>Type in <gui>Location (URI)</gui> the URL of your Web site, with a slightly modification. The modification refers
-     in replacing "https" with "davs". For example, instead of "https://example.edu.pe:8443/";; you have to type
-     "davs://example.edu.pe:8443/".</p>
+  <p>For <gui>Location (URI)</gui> enter the URL of your Web site, replacing
+  "https" with "davs". For example, instead of "https://example.edu.pe:8443/";
+  enter "davs://example.edu.pe:8443/".</p>
 
 </page>
diff --git a/help/C/ftp.page b/help/C/ftp.page
index ab03f98..9be06b6 100644
--- a/help/C/ftp.page
+++ b/help/C/ftp.page
@@ -9,31 +9,44 @@
       <email>yrazes gmail com</email>
       <years>2011</years>
     </credit>
+    <credit type="editor">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+    </credit>
 
-    <desc>File Transfer Protocol</desc>
+    <desc>Scanning a remote file system using FTP - File Transfer Protocol</desc>
   </info>
 
   <title>File Transfer Protocol</title>
 
   <comment><cite date="2011-12-17" href="mailto:yrazes gmail com">Julita Inca</cite>
-    <p>This assumes the reader knows there are many forms to establish connection remotely to scan folders.</p>
+    <p>This assumes the reader knows there are many forms to establish
+    connection remotely to scan folders.</p>
   </comment>
   
-  <p>You can access a remote server by using FTP Protocol:</p>
+  <p>To scan remotely using the FTP Protocol:</p>
 
   <steps>
-    <item><p>Click <gui>FTP (with login)</gui> as a Service type.</p></item>
-    <item><p>Write the name or address server to establish the connection.</p></item>
-    <item><p>Add some <gui>Optional information</gui></p>
-      <p>The <gui>Port</gui> to connect to on the server is 21.</p>
-      <p>The <gui>Folder</gui> you want to scan has to be written considering the initial route <gui>/</gui>.</p>
-      <p>The <gui>User Name</gui> is the name of the account used to connect to the server.</p></item>
+    <item>
+      <p>Click <gui>FTP (with login)</gui> as the <gui>Service type</gui>.</p>
+    </item>
+    <item>
+      <p>Enter the name of the remote <gui>Server</gui>.</p>
+    </item>
+    <item>
+      <p>Add the following <gui>Optional information</gui>:</p>
+      <p>The <gui>Port</gui> for this protocol is 21;</p>
+      <p>The <gui>Folder</gui> to be scanned beginning with a <file>/</file>;</p>
+      <p>The <gui>User Name</gui> of the account used to connect to the server.</p>
+    </item>
   </steps>
   
   <note style="important">
-    <p>If you select <gui>Public FTP</gui> as a Service type the user name information is not neccesary because the user is usually anonymous.</p>
+    <p>If you select <gui>Public FTP</gui> as a <gui>Service type</gui> the user
+    information is not neccesary because the user is usually anonymous.</p>
   </note>
  
-  <p>You can read more about this protocol <link href="http://www.ietf.org/rfc/rfc959.txt";>here</link>.</p>
+  <p>You can read more about this protocol
+  <link href="http://www.ietf.org/rfc/rfc959.txt";>here</link>.</p>
 
 </page>
diff --git a/help/C/multi-core.page b/help/C/multi-core.page
index 0669e10..42a6c0e 100644
--- a/help/C/multi-core.page
+++ b/help/C/multi-core.page
@@ -9,27 +9,32 @@
       <email>yrazes gmail com</email>
       <years>2011</years>
     </credit>
+    <credit type="editor">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+    </credit>
 
-    <desc>Maybe you have several hard disks in your computer that need to be scanned.</desc>
+    <desc>Choose which physical devices in your computer are scanned.</desc>
   </info>
 
-  <title>Can I scan separately my disks if I have more than one?</title>
+  <title>Can I scan my disks separately if I have more than one?</title>
 
   <comment>
     <cite date="2011-12-25" href="mailto:yrazes gmail com">Julita Inca</cite>
-    <p>This assumes the reader knows how to use the 'df' command, or at least knows what is the 
-    disk is usually used. By the end of this page, the reader will be able to scan hard disk separately.</p>
+    <p>This assumes the reader knows how to use the 'df' command, or at least
+    knows what is the disk is usually used. By the end of this page, the reader
+    will be able to scan hard disk separately.</p>
   </comment>
 
-  <p>It is possible that your computer have more than one hard disk inside, 
-  but you know it is only one or two usually used.</p><p>To custom hard disk scan:</p>
+  <p>It is possible that your computer has more than one hard disk inside, but
+  only one or two are usually used. To customize the hard disk scan:</p>
 
   <steps>
-    <item><p>Clik <gui>Edit</gui> from the menu.</p></item>
-    <item><p>Select <gui>Preferences</gui>.</p>
-      <p>Enable <gui><app>Monitor</app> changes to your <file>home</file> folder</gui> 
-      if you want to move all the information of <app>Monitor</app> to the actual <gui>Home</gui> folder.</p>
-      <p><app>Monitor</app> provides further realtime information of Linux logs.</p></item>
-   
+    <item><p>Click the <gui>Edit</gui> menu.</p></item>
+    <item><p>Select <gui>Preferences</gui>.</p></item>
+    <item><p>Use the checkboxes to select only the physical disk or disks to be
+    scanned.</p></item>
+    <item><p>Check <gui>Monitor changes to your home folder</gui> to be notified
+    when files are added to or removed from the <file>Home</file> folder.</p></item>
   </steps>
 </page>
diff --git a/help/C/no-come-up.page b/help/C/no-come-up.page
index 5eb5a5d..2fefd74 100644
--- a/help/C/no-come-up.page
+++ b/help/C/no-come-up.page
@@ -9,8 +9,12 @@
       <email>yrazes gmail com</email>
       <years>2011</years>
     </credit>
+    <credit type="editor">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+    </credit>
 
-    <desc>When you click on Disk Usage Analyzer icon and nothing happens.</desc>
+    <desc>What to do when nothing happens.</desc>
   </info>
 
   <title>I click on Disk Usage Analyzer and nothing comes up</title>
@@ -21,14 +25,16 @@
     the reader will be able to use commands on terminal.</p>
   </comment>
 
-  <p>Try these options:</p>
+  <p>If <app>Disk Usage Analyzer</app> fails to launch:</p>
 
   <list>
-    <item><p>Open a command line and try to run <app>baobab</app> from there, 
-    to see if any warnings that pop up on the command line.</p></item>
-    <item><p>If you receive a segmentation fault message, remove the ~/.gconf/apps/baobab folder</p>.</item>
+    <item><p>Open a shell window and try to run <app>baobab</app> from the
+    command line. Take note of any warnings that result.</p></item>
+    <item><p>If you receive a segmentation fault message, remove the
+    ~/.gconf/apps/baobab folder.</p></item>
   </list>
   
-  <p>See more details <link href="https://help.ubuntu.com/community/Baobab";>here</link>.</p>
+  <p>For more details, look
+  <link href="https://help.ubuntu.com/community/Baobab";>here</link>.</p>
 
 </page>
diff --git a/help/C/scan-filesystem.page b/help/C/scan-filesystem.page
index 5e4b268..2d5b2d9 100644
--- a/help/C/scan-filesystem.page
+++ b/help/C/scan-filesystem.page
@@ -15,7 +15,7 @@
       <email>kittykat3756 gmail com</email>
     </credit>
 
-    <desc>Scan all the folders in your internal and external disk.</desc>
+    <desc>Scan all the folders on internal and external disks.</desc>
   </info>
 
   <title>Scan the filesystem</title>
@@ -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-home.page b/help/C/scan-home.page
index f30a51a..4164592 100644
--- a/help/C/scan-home.page
+++ b/help/C/scan-home.page
@@ -46,7 +46,7 @@
     created by applications when they are needed.</p>
   </note>
 
-  <p>To scan your <file>Home</file> folder:</p>
+  <p>To scan your <file>Home</file> folder, choose one of the following:</p>
   <list>
     <item><p>select <guiseq><gui>Analyzer</gui><gui>Scan Home
     Folder</gui></guiseq> from the menu</p>.</item>
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>
diff --git a/help/C/ssh.page b/help/C/ssh.page
index bfc89f4..ec8f74b 100644
--- a/help/C/ssh.page
+++ b/help/C/ssh.page
@@ -9,27 +9,41 @@
       <email>yrazes gmail com</email>
       <years>2011</years>
     </credit>
+    <credit type="editor">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+    </credit>
 
-    <desc>Displaying a multilevel pie chart of a remote file system over SSH - Secure Shell Protocol</desc>
+    <desc>Scanning a remote file system using SSH - Secure Shell Protocol</desc>
   </info>
 
   <title>Secure Shell Protocol</title>
 
   <comment><cite date="2011-12-19" href="mailto:yrazes gmail com">Julita Inca</cite>
-  <p>This assumes the reader knows there are many forms to establish connection remotely to scan folders.</p></comment>
+  <p>This assumes the reader knows there are many forms to establish connection
+  remotely to scan folders.</p></comment>
 
-  <p>Use your SSH credentials and configure the scanning process by doing:</p>    
+  <p>To scan remotely using your SSH credentials:</p>    
 
   <steps>
-    <item><p>Click <gui>SSH</gui> as a Service type.</p></item>
-    <item><p>Write the name your server to establish the connection on  <gui>Server</gui>.</p></item>
-    <item><p>Add some <gui>Optional information</gui></p>
-      <p>The <gui>Port</gui> of this protocol is 22.</p>
-      <p>The <gui>Folder</gui> is the folder you want to scan, consider <gui>/</gui> to write the specific route</p>
-      <p>The <gui>User Name</gui> is the name of the account used to connect to the server.</p></item>
+    <item>
+      <p>Click <gui>SSH</gui> as a <gui>Service type</gui>.</p>
+    </item>
+    <item>
+      <p>Enter the name of the remote <gui>Server</gui>.</p>
+    </item>
+    <item>
+      <p>Add the following <gui>Optional information</gui>:</p>
+      <p>The <gui>Port</gui> for this protocol is 22;</p>
+      <p>The <gui>Folder</gui> to be scanned beginning with a <file>/</file>;</p>
+      <p>The <gui>User Name</gui> of the account used to connect to the server.</p>
+    </item>
   </steps>
 
-  <p>You can read more about this <link href="http://www.ietf.org/rfc/rfc4251.txt";>protocol</link> and 
-  get more help <link href="https://live.gnome.org/DejaDup/Help/Restore/WorstCase";>here</link></p>
+  <p>You can read more about this
+    <link href="http://www.ietf.org/rfc/rfc4251.txt";>protocol</link>
+    and get more help
+    <link href="https://live.gnome.org/DejaDup/Help/Restore/WorstCase";>here</link>
+  </p>
 
 </page>
diff --git a/help/C/view-rings.page b/help/C/view-rings.page
index 934bab3..fa38fb6 100644
--- a/help/C/view-rings.page
+++ b/help/C/view-rings.page
@@ -9,36 +9,42 @@
       <email>yrazes gmail com</email>
       <years>2011</years>
     </credit>
+    <credit type="editor">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+    </credit>
 
-    <desc>Display the results in graphics like pie charts or rectangle charts grouped in a form like tree.</desc>
+    <desc>Display the results as a pie chart or a tree chart.</desc>
 
   </info>
 
   <title>View as Rings Chart/ View as Treemap Chart</title>
 
   <comment><cite date="2011-12-19" href="mailto:yrazes gmail com">Julita Inca</cite>
-  <p>This assumes the reader knows how to scan any folder, it can be local or remote. 
-  By the end of this page, the reader will be able to read the percentage of usage and capacity on each folder scanned.</p></comment>
+  <p>This assumes the reader knows how to scan any folder, it can be local or
+  remote. By the end of this page, the reader will be able to read the
+  percentage of usage and capacity on each folder scanned.</p></comment>
 
-  <p>By default, the results of the scanning show each subfolder displayed as a sector of the ring with a proportional 
-  angle to the size of the host folder. 
-  The sub-folders are shown in different colors. Sub-folder representation depth is displayed up to a maximum of five levels, 
-  with the black level on the chart representing the folders with the most depth.</p>
+  <p>By default, the results a scan show each subfolder as the sector of a ring
+  comprising an angle proportional to the size of the host folder. Sub-folders
+  are shown in different colors to a depth of five levels, with black
+  representing the deepest folders.</p>
 
   <note style="normal">
-     <p>Move your mouse over the rings chart and see what folders are represented by each color. 
-     You can see details like name of the folder and the usage in KB or MB units.</p>
-     <p>If you selected the center of the ring which is the blank part, it will show the total capacity 
-     and the name of the folders that are contain as subfolders in the next level of the rings.</p>
+     <p>Mousing over the rings chart reveals details of the folder represented
+     by each color and its usage in KB or MB. Selecting the empty center of the
+     ring displays the total capacity and names of sub-folders contained in the
+     next level of rings.</p>
   </note>
 
-  <p>You can toggle chart visibility from the drop down menu located on the right-hand side. 
-  The Tree layout displays the same information in the form of square and rectangular graphs. 
-  The subfolder visualization is displayed in the same way as the ring charts with up to five maximum levels.</p>
+  <p>Chart visibility can be toggled to Treemap View using the drop-down menu
+  on the right-hand side. The tree layout displays the usage information in the
+  form of square and rectangular boxes, proportional in size to the amount of
+  disk space used. Sub-folders shown to a depth of five levels, with black
+  again representing the deepest folders.</p>
 
   <note style="normal">
-     <p>Move your mouse over the treemap chart and see what folders are represented by each color. 
-     You can see details like name of the folder and the usage in KB or MB units.</p>
-     <p>The size of the boxes is proportional to the amount of disk space being taken up.</p>
+     <p>Mousing over the treemap chart reveals details of the folder represented
+     by each color and its usage in KB or MB.</p>
   </note>
 </page>
diff --git a/help/C/virtual-folders.page b/help/C/virtual-folders.page
index 0611b7e..5b95665 100644
--- a/help/C/virtual-folders.page
+++ b/help/C/virtual-folders.page
@@ -9,24 +9,32 @@
       <email>yrazes gmail com</email>
       <years>2011</years>
     </credit>
+    <credit type="editor">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+    </credit>
 
-    <desc>The list shown in command line does not match with the graphic list in <app>baobab</app>.</desc>
+    <desc>The directory listing from the command line does not match the list
+    in <app>baobab</app>.</desc>
   </info>
 
-  <title>Why not all the folders are shown in the scan filesystem option?</title>
+  <title>Why are all the folders not shown in the scan filesystem option?</title>
 
   <comment>
     <cite date="2011-12-25" href="mailto:yrazes gmail com">Julita Inca</cite>
-    <p>This assumes the reader knows about the folders that can be listed in the filesystem.
-    By the end of this page, the reader will be able to learn more about virtual folders.</p>
+    <p>This assumes the reader knows about the folders that can be listed in the
+    filesystem. By the end of this page, the reader will be able to learn more
+    about virtual folders.</p>
   </comment>
 
-  <p>When you start or restart your computer there are some folders that are created with 0 size.
-  These folders contain information like timestamp and other features that only an administrator
-  can manage because it affects the configuration of the whole system.</p>
-  <p><file>/proc</file> is one folder of that type.</p>
+  <p>When you start or restart your computer some folders are created that have
+  0 size. These folders contain information like timestamps and other features
+  that only an administrator can manage because they affect the configuration of
+  the whole system.</p>
+  <p><file>/proc</file> is a folder of this type.</p>
 
   <note style="tip">
-   <p>You can learn more about these kind of folders <link href="http://unixhelp.ed.ac.uk/CGI/man-cgi?proc+5";>here</link></p>
+   <p>You can learn more about this kind of folders
+   <link href="http://unixhelp.ed.ac.uk/CGI/man-cgi?proc+5";>here</link></p>
   </note>
 </page>
diff --git a/help/C/web-dav.page b/help/C/web-dav.page
index 4a42593..c6ce639 100644
--- a/help/C/web-dav.page
+++ b/help/C/web-dav.page
@@ -9,35 +9,53 @@
       <email>yrazes gmail com</email>
       <years>2011</years>
     </credit>
+    <credit type="editor">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+    </credit>
 
-    <desc>WebDAV (HTTP) Protocol</desc>
+    <desc>Scanning a remote file system using the WebDAV (HTTP) Protocol.</desc>
   </info>
 
   <title>WebDAV (HTTP) Protocol</title>
 
   <comment><cite date="2011-12-19" href="mailto:yrazes gmail com">Julita Inca</cite>
-   <p>This assumes the reader knows there are many forms to establish connection remotely to scan folders.</p>
+   <p>This assumes the reader knows there are many forms to establish connection
+   remotely to scan folders.</p>
   </comment>
  
-  <p>The WebDAV protocol makes documents on the Web readables and writables. You can create, 
-  change and move documents within a web server or web share. 
-  You can also lock (âoverwrite preventionâ) and make queries of information about author and modified date.</p> 
+  <p>The WebDAV protocol makes documents on the Web readable and writable. You
+  can create, change and move documents within a web server or web share. You
+  can also lock (âoverwrite preventionâ) and make queries of information about
+  author and modified date.</p> 
+
+  <p>To scan remotely using the WebDAV (HTTP) Protocol:</p>
 
   <steps>
-     <item><p>Click <gui>WebDAV (HTTP)</gui> as a Service type.</p></item>
-     <item><p>Write the name your server to establish the connection on  <gui>Server</gui>.</p></item>
-     <item><p>Add some <gui>Optional information</gui></p>
-      <p>The <gui>Port</gui> of this protocol is 22880.</p>
-      <p>The <gui>Folder</gui> is the folder you want to scan, consider <gui>/</gui> to write the specific route</p>
-      <p>The <gui>User Name</gui> is the name of the account used to connect to the server.</p></item>
+    <item>
+      <p>Click <gui>WebDAV (HTTP)</gui> as the <gui>Service type</gui>.</p>
+    </item>
+    <item>
+      <p>Enter the name of the remote <gui>Server</gui>.</p>
+    </item>
+    <item>
+      <p>Add the following <gui>Optional information</gui>:</p>
+      <p>The <gui>Port</gui> of this protocol is 22880;</p>
+      <p>The <gui>Folder</gui> to be scanned, beginning with a <file>/</file>;</p>
+      <p>The <gui>User Name</gui> of the account used to connect to the server.</p>
+    </item>
   </steps>
   
   <note style="important">
-   <p>Secure WebDAV requires the port 5006 be opened.</p>
+    <p><gui>Secure WebDAV (HTTPS)</gui> requires 5006 to be entered for
+    <gui>Port</gui>.</p>
   </note>
 
   <note style="tip">
-    <p>You can see more details of the <link href="http://www.ietf.org/rfc/rfc5397.txt";>WebDAV protocol</link> and learn more <link href="http://unixwiz.net/techtips/ms971492-webdav-vuln.html";> here</link>.</p>
+    <p>You can see more details of the
+    <link href="http://www.ietf.org/rfc/rfc5397.txt";>WebDAV protocol</link>
+    and learn more
+    <link href="http://unixwiz.net/techtips/ms971492-webdav-vuln.html";> here</link>.</p>
   </note>
 
 </page>
diff --git a/help/C/windows-share.page b/help/C/windows-share.page
index 0e3462a..b0e19dc 100644
--- a/help/C/windows-share.page
+++ b/help/C/windows-share.page
@@ -9,23 +9,36 @@
       <email>yrazes gmail com</email>
       <years>2011</years>
     </credit>
+    <credit type="editor">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+    </credit>
 
-    <desc>Windows Share Protocol</desc>
+    <desc>Scanning a remote file system using the Windows Share Protocol.</desc>
   </info>
 
   <title>Windows Share Protocol</title>
 
   <comment><cite date="2011-12-19" href="mailto:yrazes gmail com">Julita Inca</cite>
-   <p>This assumes the reader knows there are many forms to establish connection remotely to scan folders.</p>
+   <p>This assumes the reader knows there are many forms to establish connection
+   remotely to scan folders.</p>
   </comment>
 
+  <p>To scan remotely using the Windows Share Protocol:</p>
+
   <steps>
-    <item><p>Click <gui>Windows Share</gui> as a Service type.</p></item>
-    <item><p>Write the name your server to establish the connection on  <gui>Server</gui>.</p></item>
-    <item><p>Add some <gui>Optional information</gui>:</p>
-      <p>The name of the Windows <gui>Share</gui>.</p>
-      <p>The <gui>Folder</gui> is the folder you want to scan, consider <gui>/</gui> to write the specific route.</p>
-      <p>The <gui>User Name</gui> is the name of the account used to connect to the server.</p></item>
-      <p>The <gui>Domain Name</gui> is the name of the Windows domain.</p>
+    <item>
+      <p>Click <gui>Windows share</gui> as the <gui>Service type</gui>.</p>
+    </item>
+    <item>
+      <p>Enter the name of the remote Windows <gui>Server</gui>.</p>
+    </item>
+    <item>
+      <p>Add the following <gui>Optional information</gui>:</p>
+      <p>The name of the Windows <gui>Share</gui>;</p>
+      <p>The <gui>Folder</gui> to be scanned, beginning with a <file>/</file>;</p>
+      <p>The <gui>User Name</gui> of the account used to connect to the server;</p>
+      <p>The Windows <gui>Domain Name</gui>.</p>
+    </item>
   </steps>
 </page>



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