[gnome-user-docs] Disk candidates



commit 136f6742d2fb94fc46528efbccc3ac2716bb5f6d
Author: Michael Hill <mdhill src gnome org>
Date:   Fri Oct 7 17:35:40 2011 -0400

    Disk candidates

 gnome-help/C/disk-benchmark.page  |   36 ++++++++++----
 gnome-help/C/disk-capacity.page   |   94 +++++++++++++++++++++++++++---------
 gnome-help/C/disk-check.page      |   68 ++++++++++++++++-----------
 gnome-help/C/disk-format.page     |   62 +++++++++++++++++-------
 gnome-help/C/disk-partitions.page |   52 ++++++++++++++++----
 gnome-help/C/disk.page            |    2 +
 6 files changed, 224 insertions(+), 90 deletions(-)
---
diff --git a/gnome-help/C/disk-benchmark.page b/gnome-help/C/disk-benchmark.page
index 2a08f75..301d1fb 100644
--- a/gnome-help/C/disk-benchmark.page
+++ b/gnome-help/C/disk-benchmark.page
@@ -4,6 +4,7 @@
   <info>
     <link type="guide" xref="disk"/>
 
+    <revision pkgversion="3.2" date="2011-10-07" status="candidate"/>
     
     <credit type="author">
       <name>GNOME Documentation Project</name>
@@ -14,26 +15,41 @@
       <email>nruz alumnos inf utfsm cl</email>
     </credit>
 
-    <desc>You can run benchmarks on your hard disk to check how fast it is.</desc>
+    <desc>Run benchmarks on your hard disk to check how fast it is.</desc>
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
 <title>Test the performance of your hard disk</title>
 
-<p>If you want to perform benchmark test and see how fast is your hard disk:</p>
+  <p>To test the speed your hard disk:</p>
 
 <steps>
 
-    <item><p>Open the <app>Disk Utility</app> application from the <gui>Activities</gui> overview.</p></item>
-    <item><p>You can choose the hard disk from the <gui>Storage Devices</gui> list. Information about the disk and its status will appear under  <gui>Drive</gui>.</p></item>
-    <item><p>Choose <gui>Benchmark</gui>.</p></item>
-    <item><p>Click <gui>Start Read-Only Benchmark</gui> to test how fast data can be read off the disk or <gui>Start Read/Write Benchmark</gui> to  test how fast data can be read off the disk and how fast data can be put onto the disk. The last option will take longer to complete.</p></item>
+ <item>
+  <p>Open the <app>Disk Utility</app> application from the <gui>Activities</gui>
+  overview.</p>
+ </item>
+ <item>
+  <p>Choose the hard disk from the <gui>Storage Devices</gui> list. Information
+  about the disk and its status will appear under  <gui>Drive</gui>.</p></item>
+ <item>
+  <p>Choose <gui>Benchmark</gui>.</p>
+ </item>
+ <item>
+  <p>Click <gui>Start Read-Only Benchmark</gui> to test how fast data can be
+  read from the disk or <gui>Start Read/Write Benchmark</gui> to test how fast
+  data can be read from and written to the disk.  The latter option will take
+  longer to complete.</p>
+ </item>
 
 </steps> 
 
-<p>When the test is finished, the results will appear on the graph.</p>
+  <p>When the test is finished, the results will appear on the graph.</p>
+
+ <comment>
+  <p>It would be really really great if somebody could write something about the
+  results and the charts, I can't do that... I don't really know what does it
+  mean. thanks.</p>
+ </comment>
 
-<comment>
- <p>It would be really really great if somebody could write something about the results and the charts, I can't do that... I don't really know what does it mean. thanks.</p>
-</comment>
 </page>
diff --git a/gnome-help/C/disk-capacity.page b/gnome-help/C/disk-capacity.page
index 688c66c..79167da 100644
--- a/gnome-help/C/disk-capacity.page
+++ b/gnome-help/C/disk-capacity.page
@@ -3,7 +3,6 @@
       id="disk-capacity">
   <info>
     <link type="guide" xref="disk"/>
-
     
     <credit type="author">
       <name>GNOME Documentation Project</name>
@@ -14,47 +13,94 @@
       <email>nruz alumnos inf utfsm cl</email>
     </credit>
 
-    <desc>With <gui>Disk Usage Analyzer</gui> or <gui>System Monitor</gui>.</desc>
+    <desc>Use <gui>Disk Usage Analyzer</gui> or <gui>System Monitor</gui> to
+ check space and capacity.</desc>
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
 <title>Check how much disk space is left</title>
-<p>You can check how much disk space is left by using <app>Disk Usage Analyzer</app> and <app>System Monitor</app>.</p>
-<section id="disk-usage-analyzer"><title>Check with Disk Usage Analyzer</title>
-<p>To check the free disk space and disk capacity using <app>Disk Usage Analyzer</app>:</p>
+
+  <p>You can check how much disk space is left with <app>Disk Usage Analyzer</app>
+ or <app>System Monitor</app>.</p>
+
+<section id="disk-usage-analyzer">
+<title>Check with Disk Usage Analyzer</title>
+
+  <p>To check the free disk space and disk capacity using
+ <app>Disk Usage Analyzer</app>:</p>
 
 <comment>
   <cite date="2011-04-04">shaunm</cite>
   <p>Rewrite steps to use common simple form in 3.0.1</p>
 </comment>
 
-<steps>
-     <item><p>Open the <app>Disk Usage Analyzer</app> application from the <gui>Activities</gui> overview.</p></item>
-     <item><p>The <app>Disk Usage Analyzer</app> window will display the <gui>Total file system capacity</gui> and <gui>Total file system usage</gui>.</p><p>(You can click on <gui>View as Rings Chart</gui> to change the display to <gui>View as Treemap Chart</gui>).</p></item> 
-    <item><p>Click <gui>Scan Home</gui> if you want to check how much disk space is left inside the Home folder or click <gui>Scan filesystem</gui> icon if you want to check how much disk space is left inside the '/' (Root) folder. In both cases, the location of the files and other options like Usage, Size and Contents will be presented. You can change the order of the details and view the files in order of file size.</p></item>
-    <item><p>Click the <gui>Scan a folder</gui> icon if you want to scan disk space inside specific folder or click <gui>Scan a remote folder</gui> if you want to scan disk space inside remote folder. See more details in <link href="ghelp:baobab?baobab-usage"><app>Disk Usage Analyzer</app></link></p></item>
-    <item><p>Click <gui>Stop</gui> or <gui>Refresh</gui> anytime you need to cancel or update the scanning.</p></item>
-  </steps>
-
+<list>
+ <item>
+  <p>Open <app>Disk Usage Analyzer</app> from the <gui>Activities</gui>
+  overview. The window will display the <gui>Total file system capacity</gui>
+  and <gui>Total file system usage</gui>.</p>
+  <p>Click to toggle between <gui>View as Rings Chart</gui> and
+  <gui>View as Treemap Chart</gui>.</p>
+ </item> 
+ <item>
+  <p>Click <gui>Scan Home</gui> to check the disk space in the Home folder or
+  the <gui>Scan filesystem</gui> icon to check the '/' (Root) folder. The
+  information is displayed according to <gui>Folder</gui>, <gui>Usage</gui>,
+  <gui>Size</gui> and <gui>Contents</gui>. Click on the column headings to
+  adjust the sort order.</p>
+ </item>
+ <item>
+  <p>Click the <gui>Scan a folder</gui> icon to scan disk space inside a
+  specific folder or click <gui>Scan a remote folder</gui> to scan disk space inside remote folder. See more details in
+  <link href="ghelp:baobab?baobab-usage"><app>Disk Usage Analyzer</app></link>.</p>
+ </item>
+ <item>
+  <p>Click <gui>Stop</gui> or <gui>Refresh</gui> anytime you need to cancel or
+  update the scanning.</p>
+ </item>
+</list>
 
-<note style="tip"><p><gui>Disk Usage Analyzer</gui> can also be run by pressing <keyseq><key>Alt</key><key>F2</key></keyseq>, typing 'baobab' (without the single-quotes) and pressing <key>Enter</key>.</p></note>
+<note style="tip">
+  <p><gui>Disk Usage Analyzer</gui> can also be run by pressing
+ <keyseq><key>Alt</key><key>F2</key></keyseq>, typing 'baobab' (without the
+ single-quotes) and pressing <key>Enter</key>.</p>
+</note>
 
 </section>
 
-<section id="system-monitor"><title>Check with System Monitor</title>
+<section id="system-monitor">
+
+<title>Check with System Monitor</title>
+
+  <p>To check the free disk space and disk capacity with <app>System Monitor</app>:</p>
 
-<p>To check the free disk space and disk capacity with <app>System Monitor</app>:</p>
 <steps>
-    <item><p>Open the <app>System Monitor</app> application from the <gui>Activities</gui> overview.</p></item>
-    <item><p>Select the <gui>File Systems</gui> tab to view the system's partitions and disk space usage in Total, Free, Available and Used.</p></item>
+ <item>
+  <p>Open the <app>System Monitor</app> application from the <gui>Activities</gui>
+  overview.</p>
+ </item>
+ <item>
+  <p>Select the <gui>File Systems</gui> tab to view the system's partitions and
+  disk space usage in Total, Free, Available and Used.</p>
+ </item>
 </steps>
 </section>
-<section id="disk-full"><title>What if the disk is too full?</title>
-<p>If the disk is too full you should:</p>
-   <list>
-       <item><p>Delete files that aren't important or that you won't use anymore.</p></item>
-       <item><p>Make <link xref="backup-why">backups</link> of the important files that you won't need for a while and delete them from the hard drive.</p></item>
-   </list>
+
+<section id="disk-full">
+
+<title>What if the disk is too full?</title>
+
+  <p>If the disk is too full you should:</p>
+
+ <list>
+  <item>
+   <p>Delete files that aren't important or that you won't use anymore.</p>
+  </item>
+  <item>
+   <p>Make <link xref="backup-why">backups</link> of the important files that
+   you won't need for a while and delete them from the hard drive.</p>
+  </item>
+ </list>
 </section>
 
 </page>
diff --git a/gnome-help/C/disk-check.page b/gnome-help/C/disk-check.page
index e3adaa2..8643de7 100644
--- a/gnome-help/C/disk-check.page
+++ b/gnome-help/C/disk-check.page
@@ -14,7 +14,9 @@
       <email>nruz alumnos inf utfsm cl</email>
     </credit>
 
-    <desc>You can test your hard disk for problems to make sure that it's healthy.</desc>
+    <revision pkgversion="3.2" date="2011-10-07" status="candidate"/>
+
+    <desc>Test your hard disk for problems to make sure that it's healthy.</desc>
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
@@ -24,45 +26,57 @@
   <cite date="2011-04-04">shaunm</cite>
   <p>Rewrite steps to use common simple form in 3.0.1</p>
 </comment>
+
 <section id="disk-status">
  <title>Checking the hard disk</title>
   <p>Hard disks have a built-in health-check tool called <app>SMART</app> 
-(Self-Monitoring, Analysis, and Reporting Technology), which continually 
-checks the disk for potential problems. SMART also warns you if the disk 
-is about to fail, helping you avoid loss of important data.</p>
+ (Self-Monitoring, Analysis, and Reporting Technology), which continually 
+ checks the disk for potential problems. SMART also warns you if the disk 
+ is about to fail, helping you avoid loss of important data.</p>
 
   <p>Although SMART runs automatically, you can also check your disk's 
-health by running the <app>Disk Utility</app> application:</p>
+ health by running the <app>Disk Utility</app> application:</p>
 
 <steps>
-  <title>Check your disk's health using the Disk Utility application</title>
-     <item><p>Open the <app>Disk Utility</app> application from the 
-<gui>Activities</gui> overview.</p></item>
-     <item><p>Select the disk you want to check from the <gui>Storage Devices
-</gui> list. Information and status of the disk will appear under <gui>Drive
-</gui>.</p></item>
-     <item><p><gui>SMART Status</gui> should say "Disk is healthy".</p></item> 
-     <item><p>Click the <gui>SMART Data</gui> button to view more drive 
-information, or to run a self-test.</p></item>
+ <title>Check your disk's health using the Disk Utility application</title>
+ 
+ <item>
+  <p>Open the <app>Disk Utility</app> application from the <gui>Activities</gui>
+  overview.</p>
+ </item>
+ <item>
+  <p>Select the disk you want to check from the <gui>Storage Devices</gui> list.
+  Information and status of the disk will appear under <gui>Drive</gui>.</p>
+ </item>
+ <item>
+  <p><gui>SMART Status</gui> should say "Disk is healthy".</p>
+ </item> 
+ <item>
+  <p>Click the <gui>SMART Data</gui> button to view more drive information, or
+  to run a self-test.</p>
+ </item>
+
 </steps>
 
 </section>
 
 <section id="disk-not-healthy">
+ 
  <title>What if the disk isn't healthy?</title>
- <p>Even if the <gui>SMART Status</gui> indicates that the disk <em>isn't</em> 
-healthy, there may be no cause for alarm. However, it's better to be prepared 
-with a <link xref="backup-why">backup</link> to prevent data loss.</p>
-
- <p>If the status says "Pre-fail", the disk is still reasonably healthy but 
-signs of wear have been detected which mean it might fail in the near future. 
-If your hard disk (or computer) is a few years old, you are likely to see 
-this message on at least some of the health checks. You should <link 
-xref="backup-how">backup your important files regularly</link> and check 
-the disk status periodically to see if it gets worse.</p>
-
- <p>If it gets worse, you may wish to take the computer/hard disk to a 
-professional for further diagnosis or repair.</p>
+
+  <p>Even if the <gui>SMART Status</gui> indicates that the disk <em>isn't</em> 
+ healthy, there may be no cause for alarm. However, it's better to be prepared 
+ with a <link xref="backup-why">backup</link> to prevent data loss.</p>
+
+  <p>If the status says "Pre-fail", the disk is still reasonably healthy but 
+ signs of wear have been detected which mean it might fail in the near future. 
+ If your hard disk (or computer) is a few years old, you are likely to see 
+ this message on at least some of the health checks. You should 
+ <link xref="backup-how">backup your important files regularly</link> and check 
+ the disk status periodically to see if it gets worse.</p>
+
+  <p>If it gets worse, you may wish to take the computer/hard disk to a 
+ professional for further diagnosis or repair.</p>
 
 </section>
 
diff --git a/gnome-help/C/disk-format.page b/gnome-help/C/disk-format.page
index 5a895a2..0f17628 100644
--- a/gnome-help/C/disk-format.page
+++ b/gnome-help/C/disk-format.page
@@ -10,36 +10,62 @@
       <email>gnome-doc-list gnome org</email>
     </credit>
 
-    <desc>Remove all of the files and folders from an external hard disk or USB flash drive by formatting it.</desc>
+    <revision pkgversion="3.2" date="2011-10-07" status="candidate"/>
+
+    <desc>Remove all of the files and folders from an external hard disk or USB
+    flash drive by formatting it.</desc>
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
 <title>Wipe everything off a removable disk</title>
 
-<p>If you have a removable disk, like a USB memory stick or an external hard 
-disk, you may sometimes wish to completely remove all of its files and 
-folders. You can do this by <em>formatting</em> the disk - this deletes all 
-of the files on the disk and leaves it empty.</p>
+  <p>If you have a removable disk, like a USB memory stick or an external hard 
+ disk, you may sometimes wish to completely remove all of its files and 
+ folders. You can do this by <em>formatting</em> the disk - this deletes all 
+ of the files on the disk and leaves it empty.</p>
 
 <steps>
  <title>Format a removable disk</title>
- <item><p>Open the <app>Disk Utility</app> application from the <gui>Activities</gui> overview.</p></item>
- <item><p>Select the disk you want to wipe from the <gui>Storage Devices</gui> list.</p>
-  <note style="warning"><p>Make sure that you have selected the correct disk! If you choose the wrong disk, all of the files on the other disk will be deleted!</p></note></item>
- <item><p>In the Volumes section, click <gui>Unmount Volume</gui>. Then click <gui>Format Volume</gui>.</p></item>
- <item><p>In the window that pops up, choose a file system <gui>Type</gui> for the disk.</p>
-  <p>If you use the disk on Windows and Mac OS computers in addition to Linux computers, choose <gui>FAT</gui>. If you only use it on Windows, <gui>NTFS</gui> may be a better option. A brief description of the <gui>file system type</gui> will be presented as a label.</p></item>
- <item><p>Give the disk a name and click <gui>Format</gui> to begin wiping the disk.</p></item>
- <item><p>Once the formatting has finished, <gui>safely remove</gui> the disk. It should now be blank and ready to use again.</p></item>
+  <item>
+   <p>Open the <app>Disk Utility</app> application from the <gui>Activities</gui>
+   overview.</p>
+  </item>
+  <item>
+   <p>Select the disk you want to wipe from the <gui>Storage Devices</gui> list.</p>
+
+  <note style="warning">
+   <p>Make sure that you have selected the correct disk! If you choose the wrong
+ disk, all of the files on the other disk will be deleted!</p>
+  </note>
+  </item>
+  <item>
+   <p>In the Volumes section, click <gui>Unmount Volume</gui>. Then click
+   <gui>Format Volume</gui>.</p>
+  </item>
+  <item>
+   <p>In the window that pops up, choose a file system <gui>Type</gui> for the
+   disk.</p>
+   <p>If you use the disk on Windows and Mac OS computers in addition to Linux
+   computers, choose <gui>FAT</gui>. If you only use it on Windows, <gui>NTFS</gui>
+   may be a better option. A brief description of the <gui>file system type</gui>
+   will be presented as a label.</p>
+  </item>
+  <item>
+   <p>Give the disk a name and click <gui>Format</gui> to begin wiping the disk.</p>
+  </item>
+  <item>
+   <p>Once the formatting has finished, <gui>safely remove</gui> the disk. It
+   should now be blank and ready to use again.</p>
+  </item>
 </steps>
 
 <note style="warning">
  <title>Formatting a disk does not securely delete your files</title>
- <p>Formatting a disk is not a completely secure way of wiping all of its 
-data. A formatted disk will not appear to have files on it, but it is 
-possible that special recovery software could retrieve the files. If you 
-need to securely delete the files, you will need to use a command-line 
-utility, such as <app>shred</app>.</p>
+  <p>Formatting a disk is not a completely secure way of wiping all of its 
+ data. A formatted disk will not appear to have files on it, but it is 
+ possible that special recovery software could retrieve the files. If you 
+ need to securely delete the files, you will need to use a command-line 
+ utility, such as <app>shred</app>.</p>
 </note>
 
 </page>
diff --git a/gnome-help/C/disk-partitions.page b/gnome-help/C/disk-partitions.page
index d3ca267..e01bcfc 100644
--- a/gnome-help/C/disk-partitions.page
+++ b/gnome-help/C/disk-partitions.page
@@ -9,37 +9,67 @@
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
     </credit>
-   
+ 
+    <revision pkgversion="3.2" date="2011-10-07" status="candidate"/>
+  
     <desc>Understand what volumes and partitions are and use the disk utility 
     to manage them.</desc>
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-<title>Manage volumes and partitions</title>
+ <title>Manage volumes and partitions</title>
 
-<p>The word <em>volume</em> is used to describe a storage device, like a hard disk. It can also refer to a <em>part</em> of the storage on that device, because you can split the storage up into chunks. The computer makes this storage accessible via your file system in a process referred to as <em>mounting</em>. Mounted volumes may be hard drives, USB drives, DVD-RWs, SD cards, and other media. If a volume is currently mounted, you can read (and possibly write) files on it.</p>
+  <p>The word <em>volume</em> is used to describe a storage device, like a hard
+ disk. It can also refer to a <em>part</em> of the storage on that device,
+ because you can split the storage up into chunks. The computer makes this
+ storage accessible via your file system in a process referred to as
+ <em>mounting</em>. Mounted volumes may be hard drives, USB drives, DVD-RWs, SD
+ cards, and other media. If a volume is currently mounted, you can read (and
+ possibly write) files on it.</p>
 
-<p>Often, a mounted volume is called a <em>partition</em>, though they are not necessarily the same thing. A âpartitionâ refers to a <em>physical</em> area of storage on a single disk drive. Once a partition has been mounted, it can be referred to as a volume because you can access the files on it. You can think of volumes as the labeled, accessible âstorefrontsâ to the functional âback roomsâ of partitions and drives.</p>
+  <p>Often, a mounted volume is called a <em>partition</em>, though they are not
+ necessarily the same thing. A âpartitionâ refers to a <em>physical</em> area of
+ storage on a single disk drive. Once a partition has been mounted, it can be
+ referred to as a volume because you can access the files on it. You can think
+ of volumes as the labeled, accessible âstorefrontsâ to the functional âback
+ roomsâ of partitions and drives.</p>
 
 <section id="manage">
  <title>View and manage volumes and partitions using the disk utility</title>
- <p>You can check and modify your computer's storage volumes with the disk utility.</p>
+
+  <p>You can check and modify your computer's storage volumes with the disk
+ utility.</p>
+
 <steps>
  <item>
   <p>Open the <gui>Activities</gui> overview and start the <app>Disk Utility</app>.</p>
  </item>
  <item>
-  <p> In the pane marked <gui>Storage Devices</gui>, you will find hard disks, CD/DVD drives, and other physical devices. Click the device you want to inspect.</p>
+  <p> In the pane marked <gui>Storage Devices</gui>, you will find hard disks,
+  CD/DVD drives, and other physical devices. Click the device you want to
+  inspect.</p>
  </item>
  <item>
- <p> In the right pane, the area labeled <gui>Volumes</gui> provides a visual breakdown of the volumes and partitions present on the selected device. It also contains a variety of tools used to manage these volumes.</p>
- <p>Be careful: it is possible to completely erase the data on your disk with these utilities.</p>
-</item>
+  <p> In the right pane, the area labeled <gui>Volumes</gui> provides a visual
+  breakdown of the volumes and partitions present on the selected device. It
+  also contains a variety of tools used to manage these volumes.</p>
+  <p>Be careful: it is possible to completely erase the data on your disk with
+  these utilities.</p>
+ </item>
 </steps>
 
-<p>Your computer most likely has at least one <em>primary</em> partition and a single <em>swap</em> partition. The swap partition is used by the operating system for memory management, and is rarely mounted.  The primary partition contains your operating system, applications, settings, and personal files. These files can also be distributed among multiple partitions for security or convenience.</p>
+  <p>Your computer most likely has at least one <em>primary</em> partition and a
+ single <em>swap</em> partition. The swap partition is used by the operating
+ system for memory management, and is rarely mounted.  The primary partition
+ contains your operating system, applications, settings, and personal files.
+ These files can also be distributed among multiple partitions for security or
+ convenience.</p>
 
-<p>One primary partition must contain information that your computer uses to start up, or <em>boot</em>. For this reason it is sometimes called a boot partition, or boot volume. To determine if a volume is bootable, look at its <gui>Partition Flags</gui> in the disk utility. External media such as USB drives and CDs may also contain a bootable volume.</p>
+  <p>One primary partition must contain information that your computer uses to
+ start up, or <em>boot</em>. For this reason it is sometimes called a boot
+ partition, or boot volume. To determine if a volume is bootable, look at its
+ <gui>Partition Flags</gui> in the disk utility. External media such as USB
+ drives and CDs may also contain a bootable volume.</p>
 
 </section>
 
diff --git a/gnome-help/C/disk.page b/gnome-help/C/disk.page
index 851f616..22f1163 100644
--- a/gnome-help/C/disk.page
+++ b/gnome-help/C/disk.page
@@ -10,6 +10,8 @@
     <email>shaunm gnome org</email>
   </credit>
 
+  <revision pkgversion="3.2" date="2011-10-07" status="candidate"/>
+
   <desc>
     <link xref="disk-capacity">Disk space</link>,
     <link xref="disk-benchmark">performance</link>,



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