GNOME.org
 

[baobab] Update Makefile.am and first tidy of help

commit 9e028a478d682d554efb59cba3b3b7da83255d81
Author: Ekaterina Gerasimova <kittykat3756 googlemail com>
Date:   Tue Dec 20 10:06:41 2011 +0100

    Update Makefile.am and first tidy of help

 help/C/introduction.page |   65 ++++++++++++++++++++-------------
 help/C/scan-home.page    |   88 ++++++++++++++++++++++++++-------------------
 help/Makefile.am         |   25 ++++++++++++-
 3 files changed, 113 insertions(+), 65 deletions(-)
---
diff --git a/help/C/introduction.page b/help/C/introduction.page
index 4e6d8eb..ec5402c 100644
--- a/help/C/introduction.page
+++ b/help/C/introduction.page
@@ -1,42 +1,55 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic" style="task"
+      type="topic"
       id="introduction">
+
   <info>
     <revision version="0.1" date="2011-12-19" status="stub"/>
-    <link type="guide" xref="index"  group="#first"/>
+    <revision version="0.1" date="2011-12-20" status="review"/>
+    <link type="guide" xref="index" group="#first"/>
     <credit type="author copyright">
       <name>Julita Inca</name>
       <email>yrazes gmail com</email>
       <years>2011</years>
     </credit>
+    <credit type="author editor">
+      <name>Ekaterina Gerasimova</name>
+      <email>kittykat3756 gmail com</email>
+      <years>2011</years>
+    </credit>
 
-    <desc><app>Disk Usage Analyzer</app>; also referred as <app>baobab</app>, 
-          is a graphical directory tree scanner.</desc>
-   </info>
+    <desc><app>Disk Usage Analyzer</app>, also referred to as
+    <app>baobab</app>, is a graphical file system scanner.</desc>
+  </info>
 
-   <title>Introduction</title>
+  <title>Introduction</title>
 
-   <comment>
-	<cite date="2011-12-19" href="mailto:yrazes gmail com">Julita Inca</cite>
-	<p>This assumes the reader knows how to start Disk Usage Manager. 
-	By the end of this page, the reader will be able to know the features Disk Usage Manager offers.</p>
+  <comment>
+    <cite date="2011-12-19" href="mailto:yrazes gmail com">Julita Inca</cite>
+    <p>This assumes the reader knows how to start Disk Usage Manager. By the
+    end of this page, the reader will be able to know the features Disk Usage
+    Manager offers.</p>
   </comment>
 
-	<p>Ever wondered how much space your music collection is taking up on your hard disk? 
-	<app>Disk Usage Analyzer</app> is a graphical scanner application for the GNOME Desktop, 
-	which gives you a pretty visuals that tell you what you'll have to shell out for an external hard disk some time soon.</p>
-
-	<p>It scans and analyzes the usage and capacity of any folder; 
-	either the whole file system tree or any specific user-request. You can 
-	<link xref="scan-file-system"><gui>Scan Filesystem</gui></link>, 
-	<link xref="scan-home"><gui>Scan Home Folder</gui></link>, 
-	<link xref="scan-folder">Scan a folder</link> or  
-	<link xref="scan-remote"><gui>Scan a remote folder</gui></link>. </p>
-
-	<p>It also detects automatically any change made to your <file>Home</file> as far as any mounted/unmounted device.</p>
-
-	<p>By default, the results are shown in a graphical way <link xref="view-ring"><gui>View as Rings Chart</gui></link>, 
-	where each folder is colored in rectangle, but you can change to the <link xref="view-tree"><gui>View as Treemap Chart</gui></link>, 
-	where folders are colored and grouped in circles forms</p>
+  <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>
 
 </page>
diff --git a/help/C/scan-home.page b/help/C/scan-home.page
index 8596b2f..c090930 100644
--- a/help/C/scan-home.page
+++ b/help/C/scan-home.page
@@ -1,58 +1,72 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic" style="task"
       id="scan-home">
+
   <info>
     <revision version="0.1" date="2011-12-19" status="stub"/>
+    <revision version="0.1" date="2011-12-20" status="review"/>
     <link type="guide" xref="index#scan"/>
     <credit type="author copyright">
       <name>Julita Inca</name>
       <email>yrazes gmail com</email>
       <years>2011</years>
     </credit>
+    <credit type="author editor">
+      <name>Ekaterina Gerasimova</name>
+      <email>kittykat3756 gmail com</email>
+      <years>2011</years>
+    </credit>
 
-    <desc>Scan your Home folder which contains <gui>Desktop</gui>, <gui>Documents</gui>, 
-          <gui>Downloads</gui>, <gui>Videos</gui>, <gui>Pictures</gui> and <gui>Music</gui> folder.</desc>
-
-   </info>
-
-     <title>Scan Home Folder</title>
-
-
-     <comment>
-	<cite date="2011-12-17" href="mailto:yrazes gmail com">Julita Inca</cite>
-	<p>This assumes the reader knows how to know about the tree filesystem in Linux. 
-	By the end of this page, the reader will be able to use the scan home in order to organize better his or her folders.</p>
-      </comment>
+    <desc>Scan your <file>Home</file> folder, which contains
+    <file>Desktop</file>, <file>Documents</file>, <file>Downloads</file>,
+    <file>Videos</file>, <file>Pictures</file> and <file>Music</file>
+    folders.</desc>
+  </info>
 
+  <title>Scan your <file>Home</file> folder</title>
 
-      <p>One of the partitioned part in our disk that has a lot of movements, is the home folder. 
-      Most of the Linux beginners do not realize that the documents are saving by default there. 
-      This is because basic configuration set our user and others in Home folder, and User folder contains 
-      <gui>Desktop</gui>, <gui>Documents</gui>, <gui>Download</gui>, <gui>Pictures</gui>, <gui>Music</gui> 
-      and <gui>Videos</gui>. So, probably this is the first folder we know is getting full in our disk.</p>
 
-      <p>To scan Home folder:</p>
-	<list>
-		<item><p>Select from the menu, <guiseq><gui>Analyzer</gui>
-	            <gui>Scan Home</gui></guiseq>.</p></item>
-		<item><p>Click <gui>Scan Home</gui></p>
-		      <p>Choose the first button that has the form of Home folder icon</p>
-	              <p>There is a home icon, as a first button on the menu.</p></item>
-		<item><p>Press <key>CTRL</key> + <key>S</key>.</p></item>
-	</list>
+  <comment>
+    <cite date="2011-12-17" href="mailto:yrazes gmail com">Julita Inca</cite>
+    <p>This assumes the reader knows how to know about the tree file system in
+    Linux.  By the end of this page, the reader will be able to use the scan
+    home in order to organize better his or her folders.</p>
+  </comment>
 
-	<p>As soon as you get the results, you can decide which applications could be uninstalled, 
-	or which folders can be <link href="help:gnome-help/files-delete">deleted</link> or 
-	<link href="help:gnome-help/files-copy">moved</link>.</p>
+  <p>The <file>Home</file> folder is where most files are located for the
+  average user because default settings are often set to save or copy files
+  into subdirectories within it. This includes downloads from the internet,
+  documents which you work on and photos from your camera. Normally, a
+  <file>Home</file> folder exists for each user on the computer.</p>
+  
+  <note style="advanced">
+    <p>The default subdirectories are usually include <file>Desktop</file>,
+    <file>Documents</file>, <file>Downloads</file>, <file>Pictures</file> and
+    <file>Music</file>, among others: these are called <em>XDK user dirs</em>.
+    Some of these will already exist when GNOME is installed, others will be
+    created by applications as and when they are needed.</p>
+  </note>
 
-	<p>If you organized folders or delete them, and still don't have any space in your <gui>Home folder</gui>, 
-	you can do a <link href="help:gnome-help/backup-how">backup</link> of your information. 
-	If you need another disk, you have to ask a specialist to do that.</p>
+  <p>To scan your <file>Home</file> folder:</p>
+  <list>
+    <item><p>Select <guiseq><gui>Analyzer</gui> <gui>Scan Home
+    Folder</gui></guiseq> from the menu</p></item>
+    <item><p>Click <gui>Scan Home</gui> in the toolbar</p></item>
+    <item><p>Press <keyseq><key>CTRL</key><key>S</key></keyseq></p></item>
+  </list>
 
+  <p>The results may be useful in deciding which applications to uninstall, or
+  which folders can be
+  <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>Home</file> directory.</p>
 
-	<note style="tip">
-	       <p>Click <gui>Stop Scanning</gui> (a circle red icon) to cancel this process.</p>
-	       <p>Click <gui>Refresh</gui> to update the scanning process.</p>
-	</note> 
+  <note style="tip">
+    <p>Click the <gui>Stop</gui> button in the toolbar to cancel the current
+    scan.</p>
+    <p>Click <gui>Refresh</gui> to repeat the last scan.</p>
+  </note> 
 
 </page>
diff --git a/help/Makefile.am b/help/Makefile.am
index b559f19..4f7b6da 100644
--- a/help/Makefile.am
+++ b/help/Makefile.am
@@ -1,10 +1,31 @@
 include $(top_srcdir)/gnome-doc-utils.make
 dist-hook: doc-dist-hook
 
+# Module name
 DOC_MODULE = baobab
-DOC_ENTITIES = legal.xml
-DOC_INCLUDES =
 
+# List of figures to be included
+DOC_FIGURES =
+
+# List of pages
+DOC_PAGES = \
+	allocated-space.page \
+	custom-location.page \
+	ftp.page \
+	index.page \
+	introduction.page \
+	scan-file-system.page \
+	scan-folder.page \
+	scan-home.page \
+	scan-remote.page \
+	ssh.page \
+	tool-status-bar.page \
+	view-rings.page \
+	view-tree.pag \
+	web-dav.page \
+	windows-share.page
+
+# List of translations
 DOC_LINGUAS = ca cs da de el en_GB es eu fi fr it oc pl pt_BR ru sl sv uk zh_CN zh_HK zh_TW
 
 -include $(top_srcdir)/git.mk
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]