[baobab] Add common problem sections and related pages
- From: Baptiste Mille-Mathias <baptistem src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [baobab] Add common problem sections and related pages
- Date: Mon, 27 Jan 2014 23:53:49 +0000 (UTC)
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]