[baobab/mallard-documentation] Edits the whole writing based on Phil Bull review comments.



commit f4f1f2451deacec05f324dd07f4de729dfb9275b
Author: Julita Inca <yrazes gmail com>
Date:   Wed Dec 28 02:32:08 2011 -0500

    Edits the whole writing based on Phil Bull review comments.

 help/C/introduction.page    |   33 ++++++++++-----------------
 help/C/multi-core.page      |   13 +++++------
 help/C/no-come-up.page      |    3 +-
 help/C/scan-filesystem.page |   39 ++++++++++++++------------------
 help/C/scan-folder.page     |   18 ++++++---------
 help/C/scan-home.page       |   16 ++++++-------
 help/C/scan-remote.page     |   51 +++++++++++++++++-------------------------
 help/C/tool-status-bar.page |    2 +-
 help/C/view-rings.page      |   19 ++++++++++++---
 help/C/view-tree.page       |    2 +-
 help/C/virtual-folders.page |    9 +++----
 11 files changed, 93 insertions(+), 112 deletions(-)
---
diff --git a/help/C/introduction.page b/help/C/introduction.page
index 994d28d..66880c7 100644
--- a/help/C/introduction.page
+++ b/help/C/introduction.page
@@ -30,26 +30,17 @@
     Manager offers.</p>
   </comment>
 
-  <p><app>Disk Usage Analyzer</app> is a graphical scanner application for the
-  GNOME Desktop. It uses charts to graphically represent your usage of hard
-  disk space, including available space.</p>
-
-  <p>It scans and displays the volume of folders, the whole file system or
-  what you specifically request. You can scan
-  <link xref="scan-file-system">the whole filesystem</link>,
-  <link xref="scan-home">your <file>Home</file> folder</link>,
-  <link xref="scan-folder">another folder on the system</link> or
-  <link xref="scan-remote">a remote folder</link>.</p>
-
-  <p><app>Disk Usage Analyzer</app> also automatically detects any changes that
-  are made to your <file>Home</file> folder, including any mounted or
-  unmounted devices.</p>
-
-  <p>By default, the results are shown as a <link xref="view-ring"><gui>ring
-  chart</gui></link>, which shows each folder is displayed as a differently
-  colored part or a ring, or you can also use to the <link
-  xref="view-tree"><gui>treemap chart</gui></link>, where folders are shown as
-  rectangles. Both views reflect the volume of each folder and the directory
-  structure in the chart.</p>
+  <p><app>Baobab</app> can be used for checking how much disk space your files 
+  and folders take up. It uses <link xref="view-ring">charts</link> to show how 
+  much disk space is being used and you can see the remaining free space.</p>
+
+  <p><app>Baobab</app> lets you do this through
+  <link xref="scan-file-system">Scan filesystem</link>,
+  <link xref="scan-home">Scan Home</link>,
+  <link xref="scan-folder">Scan another folder on the system</link> or
+  <link xref="scan-remote">Scan a remote folder</link>.</p>
+
+  <p>The disk usage space taken up by each folder is not only useful to scan multiple internal hard drives.
+  It also works for external hard drives that are used by USB or cameras.</p>
 
 </page>
diff --git a/help/C/multi-core.page b/help/C/multi-core.page
index 23698da..0669e10 100644
--- a/help/C/multi-core.page
+++ b/help/C/multi-core.page
@@ -10,7 +10,7 @@
       <years>2011</years>
     </credit>
 
-    <desc>Maybe you have multi-core computer, but only one disk needs to be scanned.</desc>
+    <desc>Maybe you have several hard disks in your computer that need to be scanned.</desc>
   </info>
 
   <title>Can I scan separately my disks if I have more than one?</title>
@@ -26,11 +26,10 @@
 
   <steps>
     <item><p>Clik <gui>Edit</gui> from the menu.</p></item>
-    <item><p>Select <gui>Preferences</gui>.</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>
+   
   </steps>
-  <note style="normal">
-    <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>
-  </note>
 </page>
diff --git a/help/C/no-come-up.page b/help/C/no-come-up.page
index 0dd0517..5eb5a5d 100644
--- a/help/C/no-come-up.page
+++ b/help/C/no-come-up.page
@@ -24,7 +24,8 @@
   <p>Try these options:</p>
 
   <list>
-    <item><p>Open a terminal and type:</p><code>gksudo</code></item>
+    <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>
   </list>
   
diff --git a/help/C/scan-filesystem.page b/help/C/scan-filesystem.page
index eb0e1ee..5e4b268 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 the filesystem at the same time.</desc>
+    <desc>Scan all the folders in your internal and external disk.</desc>
   </info>
 
   <title>Scan the filesystem</title>
@@ -27,9 +27,8 @@
     full file system.</p>
   </comment>
 
-  <p>You can scan every folder in the filesystem at the same time, including
-  the <file>home</file>, <file>usr</file> and <file>mnt</file> directories. To
-  do this:</p>
+  <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>
 
   <list>
     <item><p>Select <guiseq><gui>Analyzer</gui><gui>Scan
@@ -38,23 +37,20 @@
     <item><p>Press <keyseq><key>Ctrl</key><key>F</key></keyseq>.</p></item>
   </list>
 
-  <note style="warning">
-    <p>If the filesystem that you are trying to scan is large, it may take
-    a few minutes for the scan to complete.</p>
+  <note style="tip">
+    <p>Click the <gui>Stop</gui> button in the toolbar to cancel the current
+    scan, or <gui>Refresh</gui> to repeat the last scan.</p>
   </note>
 
+  <p>If the disk that you are trying to scan is large, it may take
+  a few minutes for the scan to complete.</p>
+
   <comment>
     <cite date="2011-12-21" href="mailto:kittykat3756 gmail com">Ekaterina
     Gerasimova</cite>
     <p>What does this note mean? If I cannot understand it, I don't think the
     average user can eitherâ</p>
   </comment>
-  <note style="advanced">
-    <p><app>Disk Usage Analyzer</app> will display sizes in the directory tree
-    as <link xref="allocated-space">allocated space</link>. This means that
-    the displayed sizes refer to the actual disk usage and not to the apparent
-    directory size.</p>
-  </note>
 
   <p>The results may be useful in deciding which applications to uninstall, or
   which folders can be
@@ -62,17 +58,16 @@
   <link href="help:gnome-help/files-delete">deleted</link> or
   <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
-  filesystem.</p>
+  <link href="help:gnome-help/backup-how">backup</link> of your disk.</p>
 
-  <note style="important">
-    <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> 
+  <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="tip">
-    <p>Click the <gui>Stop</gui> button in the toolbar to cancel the current
-    scan, or <gui>Refresh</gui> to repeat the last scan.</p>
+  <note style="advanced">
+    <p><app>Disk Usage Analyzer</app> will display sizes in the directory tree
+    as <link xref="allocated-space">allocated space</link>. This means that
+    the displayed sizes refer to the actual disk usage and not to the apparent
+    directory size.</p>
   </note>
 
 </page>
diff --git a/help/C/scan-folder.page b/help/C/scan-folder.page
index b6dece2..1c7ff5b 100644
--- a/help/C/scan-folder.page
+++ b/help/C/scan-folder.page
@@ -22,10 +22,8 @@
   on external devices or across the computer.</p></comment>
 
   <p>If you have many folders inside one, and maybe you want to reorganize all the structure 
-  of this folder because it is too big or quite older, or maybe you are doing some maintainer 
-  job to make your system run smoothly; you probably need to know what are the heaviest folders 
-  that the folder has (folder in your home folder, on external devices, on folder servers,
-  and across your computer's file system).</p>
+  of this because it is too big or quite older; you probably need to found them to make your 
+  system run smoothly.</p>
 
   <p>You can scan a folder by doing one of these alternatives:</p>
 
@@ -35,6 +33,10 @@
      <item><p>Press <keyseq><key>CTRL</key><key>O</key></keyseq>.</p></item>
   </list>
 
+  <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>
+  </note> 
 
   <p>The results may be useful in deciding which folders compress, which applications to uninstall, 
   or which folders can be
@@ -44,13 +46,7 @@
   for a <link href="help:gnome-help/backup-how">backup</link> of your
   <file>folder</file>.</p>
 
-  <note style="important">
-    <p>Right click on any folder and select <gui>Open Folder</gui> to browse all the folders inside, 
+  <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> 
-
-  <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>
-  </note> 
 
 </page>
diff --git a/help/C/scan-home.page b/help/C/scan-home.page
index a9d4b23..f30a51a 100644
--- a/help/C/scan-home.page
+++ b/help/C/scan-home.page
@@ -41,7 +41,7 @@
   <note style="advanced">
     <p>The default subdirectories usually include <file>Desktop</file>,
     <file>Documents</file>, <file>Downloads</file>, <file>Pictures</file> and
-    <file>Music</file>, among others: these are called <em>XDG user dirs</em>.
+    <file>Music</file>, among others.
     Some of these will already exist when GNOME is installed, others will be
     created by applications when they are needed.</p>
   </note>
@@ -54,6 +54,11 @@
     <item><p>press <keyseq><key>CTRL</key><key>S</key></keyseq>.</p></item>
   </list>
 
+  <note style="tip">
+    <p>Click the <gui>Stop</gui> button 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 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
@@ -62,14 +67,7 @@
   for a <link href="help:gnome-help/backup-how">backup</link> of your
   <file>Home</file> directory.</p>
 
-  <note style="important">
-    <p>Right click on any folder and select <gui>Open Folder</gui> to browse all the folders inside, 
+  <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> 
-
-  <note style="tip">
-    <p>Click the <gui>Stop</gui> button in the toolbar to cancel the current
-    scan, or <gui>Refresh</gui> to repeat the last scan.</p>
-  </note> 
 
 </page>
diff --git a/help/C/scan-remote.page b/help/C/scan-remote.page
index 386fe5b..9f3bb3c 100644
--- a/help/C/scan-remote.page
+++ b/help/C/scan-remote.page
@@ -26,51 +26,42 @@
     folders.</p>
   </comment>
 
-  <p>Maybe you are the admin of an intranet file server: one day you are
-  greeted with an urgent notice that nobody in the company can save files to it
-  because the disks are completely full. Maybe you need to trim down the size
-  of a server's filesystem so that you can move it to a virtual server. In
-  cases like these, it is useful to be able to scan remotely from another
-  computer.</p> 
-
-  <note style="advanced">
-    <p>Make sure the remote computer is on the same network as your computer,
-    and that your account has local administrator permissions.</p>
-  </note>
+  <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>
 
   <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>
   in the toolbar.</p>
 
-  <note style="important">
-    <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> 
+  <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>Choose one of following protocols:</p>
 
   <list>
-    <item><p><link xref="ssh">SSH</link>: an acronym for Secure Shell, a
-    protocol for secure remote login and other secure network services over an
-    insecure network.</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>: an acronym for File
-    Transfer Protocol, used for sharing and transferring folders reliably and
-    efficiently. Remote computers can be scanned using one user
-    account.</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>: share files without the need
+    <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>: view and manage
-    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>: an acronym for
-    Web-based Distributed Authoring and Versioning, methods of Hypertext
-    Transfer Protocol (HTTP) that facilitate collaboration between users in
-    editing and managing documents and files 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
diff --git a/help/C/tool-status-bar.page b/help/C/tool-status-bar.page
index a444391..1408ba2 100644
--- a/help/C/tool-status-bar.page
+++ b/help/C/tool-status-bar.page
@@ -3,7 +3,7 @@
       id="tool-status-bar">
   <info>
     <revision version="0.1" date="2011-12-19" status="stub"/>
-    <link type="guide" xref="index#preferences"  group="#last"/>
+
     <credit type="author copyright">
       <name>Julita Inca</name>
       <email>yrazes gmail com</email>
diff --git a/help/C/view-rings.page b/help/C/view-rings.page
index fe11edc..934bab3 100644
--- a/help/C/view-rings.page
+++ b/help/C/view-rings.page
@@ -10,24 +10,35 @@
       <years>2011</years>
     </credit>
 
-    <desc>Display the nice pie charts of that system you drilled down.</desc>
+    <desc>Display the results in graphics like pie charts or rectangle charts grouped in a form like tree.</desc>
 
   </info>
 
-  <title>View as Rings Chart</title>
+  <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>Each subfolder is displayed as a sector of the ring with a proportional angle to the size of the host folder. 
+  <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>
 
   <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 unities.</p>
+     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>
   </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>
+
+  <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>
+  </note>
 </page>
diff --git a/help/C/view-tree.page b/help/C/view-tree.page
index 5372384..ebc1feb 100644
--- a/help/C/view-tree.page
+++ b/help/C/view-tree.page
@@ -3,7 +3,7 @@
       id="view-tree">
   <info>
     <revision version="0.1" date="2011-12-19" status="stub"/>
-    <link type="guide" xref="index#preferences"/>
+
     <credit type="author copyright">
       <name>Julita Inca</name>
       <email>yrazes gmail com</email>
diff --git a/help/C/virtual-folders.page b/help/C/virtual-folders.page
index f8a3b5d..0611b7e 100644
--- a/help/C/virtual-folders.page
+++ b/help/C/virtual-folders.page
@@ -10,7 +10,7 @@
       <years>2011</years>
     </credit>
 
-    <desc>The list shown in terminal does not match with the graphic list in Disk Usage Analyzer.</desc>
+    <desc>The list shown in command line does not match with the graphic list in <app>baobab</app>.</desc>
   </info>
 
   <title>Why not all the folders are shown in the scan filesystem option?</title>
@@ -22,10 +22,9 @@
   </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 a root user can manage
-  because it affects the configuration of the kernel.</p>
-  <p><file>/proc</file> is one folder of that type, others like <file>/vmlinuz</file> also can be found
-  if you have installed a virtual machine in your computer.</p>
+  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>
 
   <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>



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