[gnome-system-monitor/wip/mallard-help: 44/62] Update fs pages; rewrite files with licensing issues



commit db638ee387ee2acf70b08d8a05de524c86cd8c9f
Author: Phil Bull <philbull gmail com>
Date:   Mon Jan 27 14:01:19 2014 +0000

    Update fs pages; rewrite files with licensing issues

 help/C/fs-diskusage.page          |   47 +++++++++++---------
 help/C/fs-info.page               |   86 +++++++++++--------------------------
 help/C/fs-showall.page            |   26 ++++-------
 help/C/index.page                 |   16 ++-----
 help/C/process-priority-what.page |    6 +--
 5 files changed, 68 insertions(+), 113 deletions(-)
---
diff --git a/help/C/fs-diskusage.page b/help/C/fs-diskusage.page
index 95a1b8b..4a1357c 100644
--- a/help/C/fs-diskusage.page
+++ b/help/C/fs-diskusage.page
@@ -2,37 +2,42 @@
       type="topic" style="task"
       id="fs-diskusage">
   <info>
-    <revision version="0.1" date="2014-01-26" status="review"/>
+    <revision version="0.1" date="2014-01-27" status="review"/>
     <link type="guide" xref="index" group="filesystems" />
+    <link type="seealso" xref="fs-info" />
+    <link type="seealso" xref="units" />
+    
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
     <credit type="author copyright">
       <name>Phil Bull</name>
       <email>philbull gmail com</email>
-      <years>2011</years>
+      <years>2014</years>
     </credit>
 
     <desc>The <gui>File Systems</gui> tab shows how much space is being used on each hard disk.</desc>
   </info>
 
   <title>Check how much disk space is being used</title>
+  
+  <p>To check how much space is available on a disk, go to the <gui>File Systems</gui> tab and look at the 
<gui>Used</gui> and <gui>Available</gui> columns.</p>
+  
+  <p>If several devices are shown, and you are looking for the one that has your Home folder on it, look for 
the disk that has <file>/</file> or <file>/home</file> listed under <gui>Directory</gui>. This is usually 
(but not always) the disk where your personal files are stored.</p>
+  
+  
+  <section id="free-space">
+    <title>Freeing-up disk space</title>
+    
+    <p>If you don't have much disk space left, there are a few things you can do to try and free up some 
space.</p>
+    
+    <p>One is to delete unwanted files manually. You can use the <app>Disk Usage Analyzer</app> application 
to tell you which files and folders are taking up the most space. After deleting some files, you should then 
empty the <gui>Trash</gui> to make sure they are fully removed from the computer.</p>
+  
+    <p>You can also remove temporary files in various applications. For example, web browsers and software 
managers often keep sizeable temporary files around. (How you remove them depends on the application.)</p>
+    
+    <p>You can also try uninstalling some unwanted applications. Use your usual software manager to do 
this.</p>
+    
+    <p>Another way of freeing disk space is to "archive" old files by moving them to an external hard disk 
or online "cloud" storage, for example.</p>
+  
+  </section>
 
-
-  <app>Disk Usage Analyzer</app>
-
-<!--
-  <p>Low disk space can result in many issues. from not having enough space for new files to processes 
acting slower or crashing. To check your disk usage using <gui>System Monitor</gui>:</p>
-
-  <steps>
-    <item><p>Click the <gui>File Systems</gui> tab.</p></item>
-    <item><p>The columns <gui>Total</gui>, <gui>Free</gui>, <gui>Available</gui>, and <gui>Used</gui> show 
the respective amounts of memory for each device.</p></item>
-  </steps>
-
-   <p>If you find that the amount of available disk space for a device is low, there are several ways to 
increase available space.
-One way to check disk usage is to use the <app>Disk Usage Analyzer</app> program, which you can open via 
<guiseq><gui>Activities</gui><gui>Applications</gui><gui>Disk Usage Analyzer</gui></guiseq>. The <gui>Scan 
Home</gui> button will give you a breakdown of how disk space is distributed. From here you can identify 
large files that may be candidates for removal. </p>
-
-<p>Another way to clear up disk space is to remove temporary files. These will automatically be deleted on 
reboot. If you are having disk space issues and haven't rebooted your computer lately, this may clear up some 
space.</p>
-
-<note><p>One more technique is to clear package files which are not being used. Look at the documentation 
for your distribution for instructions on how to do this.
-</p></note>
--->
 </page>
diff --git a/help/C/fs-info.page b/help/C/fs-info.page
index 7101136..5ae4dc1 100644
--- a/help/C/fs-info.page
+++ b/help/C/fs-info.page
@@ -2,82 +2,46 @@
       type="topic" style="task"
       id="fs-info">
   <info>
-    <revision version="0.1" date="2011-08-19" status="review"/>
+    <revision version="0.1" date="2014-01-27" status="review"/>
     <link type="guide" xref="index" group="filesystems" />
+    <link type="seealso" xref="fs-device" />
+    <link type="seealso" xref="units" />
+    
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
     <credit type="author copyright">
       <name>Phil Bull</name>
       <email>philbull gmail com</email>
-      <years>2011</years>
-    </credit>
-    <credit type="author copyright">
-      <name>Kelly Sinnott</name>
-      <email>ksinnott5ht gmail com</email>
-      <years>2011</years>
+      <years>2014</years>
     </credit>
 
     <desc>Explanations of all of the fields shown in the <gui>File System</gui> tab.</desc>
   </info>
 
-  <title>Learn what the File System information means</title>
+  <title>Learn what the File Systems information means</title>
   
-  <!-- ================================= -->
+  <p>The File Systems tab lists which disks are attached to the computer, what they are named, and how much 
disk space is available on them.</p>
   
+  <list>
+    <item>
       <p><gui>Device</gui> lists the name that the operating system has assigned to the disk. Every bit of 
computer hardware that is attached to the computer is given an entry in the <file>/dev</file> directory that 
is used to identify it. For hard disks, it will usually look something like <file>/dev/sda</file>.</p>
+    </item>
   
-    <p><gui>Directory</gui> tells you where the disk or partition is <em>mounted</em>. Mounting is the 
technical term for making a disk or partition available for use. A disk can be physically connected to the 
computer, but unless it is also mounted, the files on it cannot be accessed. When a disk is mounted, it will 
be linked to a folder that you can then go to in order to access the files on the disk. For example, if the 
<gui>Directory</gui> is listed as <file>/media/disk</file>, you can access the files by going to the 
<file>/media/disk</file> folder on your computer.</p>
-
-    <p><gui>Type</gui> tells you the type of <em>filesystem</em> that is used on the disk or partition. The 
filesystem specifies how the computer should store files on the disk; some operating systems can only 
understand some types, and not others.</p>
+    <item>
+      <p><gui>Directory</gui> tells you where the disk or partition is <em>mounted</em>. Mounting is the 
technical term for making a disk or partition available for use. A disk can be physically connected to the 
computer, but unless it is also mounted, the files on it cannot be accessed. When a disk is mounted, it will 
be linked to a folder that you can then go to in order to access the files on the disk. For example, if the 
<gui>Directory</gui> is listed as <file>/media/disk</file>, you can access the files by going to the 
<file>/media/disk</file> folder on your computer.</p>
+    </item>
     
-    <!-- ================================= -->
-  
-  
-  
-  
-
-  <p>For each device listed in the <gui>File System</gui> tab, <app>System Monitor</app> provides 
information in a number of categories. </p>
-
-<table shade="rows">
-  <tr>
-       <td><p>Device</p></td>
-       <td><p>This column lists the system-assigned interface directory for a given device or 
partition.</p></td>
-
-  </tr>
-
-  <tr>
-       <td><p>Directory</p></td>
-       <td><p>This column contains the user-accessible location, or <em>path</em> where each device is 
<em>mounted</em> in the filesystem.</p></td>
-  </tr>
-
-  <tr>
-       <td><p>Type</p></td>
-       <td><p>The filesystem type of a device refers to the way the data is stored on it. For example, 
<cmd>ext3</cmd> filesystems are common for Home directories, while <cmd>fat32</cmd> is often seen in 
removable USB drives. </p>
-       </td>
-  </tr>
-
-  <tr>
-       <td><p>Total</p></td>
-       <td><p>This column lists the total capacity for each device.</p>
-       </td>
-   </tr>
-
-  <tr>
-       <td><p>Free</p></td>
-       <td><p>This column lists the space that is free for each device.</p></td>
-   </tr>
-
-  <tr>
-       <td><p>Available</p></td>
-       <td><p>The available disk space can be used by the system and installed programs.</p></td>
-   </tr>
-
-  <tr>
-       <td><p>Used</p></td>
-       <td><p>This column displays both the amount of disk space used and the percentage of available space 
this represents. </p></td>
-   </tr>
-
-</table>
+    <item>
+      <p><gui>Type</gui> tells you the type of <em>filesystem</em> that is used on the disk or partition. A 
filesystem specifies how the computer should store files on the disk. Some operating systems can only 
understand some filesystem types and not others, so it can be useful to check which filesystem an external 
hard disk uses, for example.</p>
+    </item>
+    
+    <item>
+      <p><gui>Total</gui> shows the total capacity of the disk and <gui>Available</gui> shows how much of 
that capacity is available to use for files and programs. <gui>Used</gui> shows how much disk space is 
already being used.</p>
+    </item>
+    
+  </list>
 
-<note><p><gui>Available</gui> space may be less than <gui>Free</gui> space. The extra space holds data 
necessary for currently running processes.</p></note>
+  <p>The sum of Used and Available will not necessarily add up to the Total. This is because some disk space 
might be reserved for use by the system. The important number to look at is the Available column, as this 
tells you how much disk space you can actually use.</p>
+  <p>You might also find that the Total doesn't match up with the advertised capacity of your hard disk. 
This is normal, and happens for a couple of reasons. One is that hard disk manufacturers use a slightly 
different way of counting disk capacity to everyone else. Another is that some disk space might be reserved 
for use by the operating system. If there is a big difference from the capacity you expect, it might be 
because your disk has been split up into multiple partitions.</p>
 
 </page>
diff --git a/help/C/fs-showall.page b/help/C/fs-showall.page
index a61b940..9e945e3 100644
--- a/help/C/fs-showall.page
+++ b/help/C/fs-showall.page
@@ -2,32 +2,26 @@
       type="topic" style="task"
       id="fs-showall">
   <info>
-    <revision version="0.1" date="2011-08-19" status="review"/>
+    <revision version="0.1" date="2014-01-27" status="review"/>
     <link type="guide" xref="index" group="filesystems" />
+    
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
     <credit type="author copyright">
       <name>Phil Bull</name>
       <email>philbull gmail com</email>
-      <years>2011</years>
-    </credit>
-    <credit type="author copyright">
-      <name>Kelly Sinnott</name>
-      <email>ksinnott5ht gmail com</email>
-      <years>2011</years>
+      <years>2014</years>
     </credit>
 
-    <desc>In addition to the file systems used to store your files, Linux also has some special ones.</desc>
+    <desc>There are hidden file systems that the operating system uses.</desc>
   </info>
 
   <title>Show all file systems, including hidden and system ones</title>
 
-  <comment>
-    <cite date="2011-06-18" href="mailto:philbull gmail com">Phil Bull</cite>
-    <p>Explain how you can show all file systems (Preferences), and (briefly) what sort of thing those file 
systems are likely to be for (system things, mounted network drives, etc.)</p>
-  </comment>
-
-  <p>It is possible for <app>System Monitor</app> to display more than the basic, user-accessible devices 
that show up in the <gui>File Systems</gui> tab. To show all the file systems that exist on your system, 
click <guiseq><gui>Edit</gui><gui>Preferences</gui><gui>Show All Filesystems.</gui></guiseq> The <gui>File 
Systems</gui> tab should now show more file systems which were not visible before.</p>
-
-<p>Devices like <cmd>proc</cmd>, <cmd>run</cmd>, and <cmd>sys</cmd> contain system files that Linux requires 
to run. You might also see systems like <cmd>gvfs-fuse-daemon</cmd> or <cmd>fusectl</cmd>; these help to 
mount a virtual file system such as one on a network or a remote computer. <cmd>tmpfs</cmd> contains 
temporary files which are deleted on boot. It is unlikely that you will need to touch these filesystems, but 
it is good to know about them</p> 
+  <p>By default, the <gui>File Systems</gui> tab only shows disks and partitions that hold your files and 
applications. There are also a number of special filesystems that the operating system uses, but these are 
hidden by default.</p>
+  
+  <p>To see these special filesystems, click <guiseq><gui>System 
Monitor</gui><gui>Preferences</gui></guiseq>, and under the <gui>File Systems</gui> tab, check <gui>Show all 
file systems</gui>.</p>
+  
+  <p>Most of the entries in the list are "virtual" filesystems. These are not real disks or partitions. 
Instead, they are used by the operating system as a convenient layer of abstraction for various things, like 
managing hardware devices and storing temporary files. The system manages these automatically, so there is 
rarely any need for you to look at them yourself.</p>
 
 </page>
diff --git a/help/C/index.page b/help/C/index.page
index 0283530..5d51015 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -2,25 +2,19 @@
       type="guide"
       id="index">
   <info>
-    <revision version="0.1" date="2011-08-19" status="review"/>
+    <revision version="0.1" date="2014-01-27" status="review"/>
     <title type='link'>System Monitor</title>
     <title type='text'>System Monitor</title>
+    
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
     <credit type="author copyright">
       <name>Phil Bull</name>
       <email>philbull gmail com</email>
-      <years>2011</years>
-    </credit>
-    <credit type="author copyright">
-      <name>Kelly Sinnott</name>
-      <email>ksinnott5ht gmail com</email>
-      <years>2011</years>
+      <years>2014</years>
     </credit>
 
-
-    <desc>Use the System Monitor to view information on how well your computer is running and whether there 
are any problems</desc>
-    
-
+    <desc>System Monitor shows you what programs are running and how much processor time, memory, and disk 
space are being used.</desc>
 
   </info>
 
diff --git a/help/C/process-priority-what.page b/help/C/process-priority-what.page
index 95dd8cf..e6da91c 100644
--- a/help/C/process-priority-what.page
+++ b/help/C/process-priority-what.page
@@ -2,13 +2,11 @@
       type="topic" style="task"
       id="process-priority-what">
   <info>
-    <revision version="0.2" pkgversion="3.11" date="2014-01-26" status="review"/>
+    <revision version="0.1" date="2014-01-26" status="stub"/>
     <link type="guide" xref="index" group="processes-info" />
     <link type="seealso" xref="process-priority-change" />
     <link type="seealso" xref="cpu-multicore" />
 
-    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
-
     <credit type="author copyright">
       <name>Phil Bull</name>
       <email>philbull gmail com</email>
@@ -18,7 +16,7 @@
     <credit type="author copyright">
       <name>Michael Hill</name>
       <email>mdhillca gmail com</email>
-      <years>2011, 2014</years>
+      <years>2011</years>
     </credit>
 
     <desc>The Nice value of a process is used to adjust its priority.</desc>


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