[baobab] Add common problem sections and related pages



commit 8d1b328092098b1c38db469eaa9f5dd81161cd22
Author: Baptiste Mille-Mathias <baptiste millemathias gmail com>
Date:   Sun Jan 26 12:23:15 2014 +0000

    Add common problem sections and related pages
    
    Add pages about slow scan and permissions problems.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=670527

 help/C/index.page                       |    6 +-
 help/C/problem-permissions.page         |   40 ++++++++++++++++
 help/C/problem-slow-scan.page           |   30 ++++++++++++
 help/C/protocol-ftp.page.stub           |   76 -------------------------------
 help/C/protocol-ssh.page.stub           |   62 -------------------------
 help/C/protocol-web-dav.page.stub       |   74 ------------------------------
 help/C/protocol-windows-share.page.stub |   62 -------------------------
 help/Makefile.am                        |    2 +
 8 files changed, 75 insertions(+), 277 deletions(-)
---
diff --git a/help/C/index.page b/help/C/index.page
index d01e2cf..b88f299 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -32,8 +32,8 @@
     <title>Preferences</title>
   </section>
 
-<!--    <section id="problems">
-       <title>Common problems and questions</title>
-    </section>-->
+  <section id="problems" style="2column">
+    <title>Common problems and questions</title>
+  </section>
 
 </page>
diff --git a/help/C/problem-permissions.page b/help/C/problem-permissions.page
new file mode 100644
index 0000000..033485b
--- /dev/null
+++ b/help/C/problem-permissions.page
@@ -0,0 +1,40 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="problem-permissions">
+  <info>
+    <link type="guide" xref="index#problems"/>
+    <revision pkgversion="3.10" date="2014-01-25" status="stub"/>
+
+    <credit type="author copyright">
+      <name>Baptiste Mille-Mathias</name>
+      <email>baptistem gnome org</email>
+      <years>2014</years>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>I see a <gui>Could not scan /… or some of the folders it
+    contains</gui> error message when scanning.</desc>
+
+  </info>
+
+  <title>Error when scanning</title>
+
+  <p>When scanning you might see a message <gui>Could not scan /… or some of the
+  folders it contains</gui> at the top of <app>Disk Usage Analyzer</app> window.
+  This error appears because you don't have the required permissions to access
+  some files due to restrictions set on the target system. The files you can't
+  access won't be used to compute the <link xref="views">chart</link>
+  representing the disk usage, hence the result reported may be wrong.</p>
+
+  <p>Not having access to all files and directories is perfectly common thought
+  so there is nothing you can do about this error.</p>
+
+  <note style="info"><p><app>Disk Usage Analyzer</app> uses command
+  <cmd>du</cmd> to create the detailled view of the use of storage, and needs
+  you have read permission on files and execute permission of directories.</p>
+
+  <p>On the other hand, filesystem disk usage on the use command <cmd>df</cmd>
+  for disk utilisation on the main window which relies on the filesystem and not
+  on file permissions.</p></note>
+</page>
diff --git a/help/C/problem-slow-scan.page b/help/C/problem-slow-scan.page
new file mode 100644
index 0000000..ceb0520
--- /dev/null
+++ b/help/C/problem-slow-scan.page
@@ -0,0 +1,30 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="problem-slow-scan">
+
+  <info>
+    <link type="guide" xref="index#problems"/>
+    <revision pkgversion="3.10" date="2014-01-25" status="stub"/>
+
+    <credit type="author copyright">
+      <name>Baptiste Mille-Mathias</name>
+      <email>baptistem gnome org</email>
+      <years>2014</years>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Scanning a folder or a remote location is slow.</desc>
+
+  </info>
+  <title>Scanning is slow</title>
+
+  <p>The speed required to scan a folder or a remote location depends on the
+  speed of the media you're scanning. For instance a mechanical hard drive will
+  be slower than a SSD, and scanning a remote directory over Internet will
+  generally take longer than scanning a folder over a local network.</p>
+
+  <p>The speed also depends on the depth of the directory structure and the
+  number of files stored.</p>
+
+</page>
diff --git a/help/Makefile.am b/help/Makefile.am
index 2733583..bc19915 100644
--- a/help/Makefile.am
+++ b/help/Makefile.am
@@ -10,6 +10,8 @@ HELP_FILES = \
        index.page \
        introduction.page \
        pref-view-chart.page \
+       problem-permissions.page \
+       problem-slow-scan.page \
        scan-file-system.page \
        scan-folder.page \
        scan-home.page \


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