[baobab/mallard-documentation] Edits for final review

From: Michael Hill <mdhill src gnome org>
To: commits-list gnome org
Cc:
Subject: [baobab/mallard-documentation] Edits for final review
Date: Wed, 1 Feb 2012 10:23:53 +0000 (UTC)
commit 9b20b80cb472fb140059d0e992c4b4059473cf0b
Author: Michael Hill <mdhill src gnome org>
Date:   Mon Jan 30 22:17:03 2012 -0500

    Edits for final review

 help/C/allocated-space.page |   21 +++++++++++++--------
 help/C/multi-core.page      |   29 +++++++++++++++++------------
 help/C/no-come-up.page      |   18 ++++++++++++------
 help/C/scan-filesystem.page |    2 +-
 help/C/scan-home.page       |    2 +-
 help/C/view-rings.page      |   40 +++++++++++++++++++++++-----------------
 help/C/view-tree.page       |   32 --------------------------------
 help/C/virtual-folders.page |   26 +++++++++++++++++---------
 8 files changed, 84 insertions(+), 86 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/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 7ce7850..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>
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/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>
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]