[gnome-system-monitor/wip/mallard-help: 48/62] Review mem-* help pages

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit 6ed8fa223d3fbbf5942ba176d07edc54ecf8a9d4
Author: Ekaterina Gerasimova <kittykat3756 gmail com>
Date:   Tue Jan 28 12:26:29 2014 +0000

    Review mem-* help pages

 help/C/mem-check.page |   57 +++++++++++++++++++++++++++---------------------
 help/C/mem-swap.page  |   35 ++++++++++++++++++------------
 2 files changed, 53 insertions(+), 39 deletions(-)
---
diff --git a/help/C/mem-check.page b/help/C/mem-check.page
index 5d4a5e3..4250232 100644
--- a/help/C/mem-check.page
+++ b/help/C/mem-check.page
@@ -1,8 +1,9 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic" style="task"
       id="mem-check">
+
   <info>
-    <revision version="0.2" pkgversion="3.11" date="2014-01-26" status="review"/>
+    <revision pkgversion="3.11" date="2014-01-28" status="candidate"/>
     <link type="guide" xref="index" group="memory" />
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
@@ -25,10 +26,10 @@
     </credit>
 
     <desc>The <gui>Resources</gui> tab tells you how much of your computer's
-    memory is being used.</desc>
+    memory (RAM) is being used.</desc>
   </info>
 
-  <title>Check how much memory (RAM) is being used</title>
+  <title>How much memory is being used?</title>
 
   <comment>
     <cite date="2011-06-18" href="mailto:philbull gmail com">Phil Bull</cite>
@@ -40,35 +41,40 @@
    <p>To check the current memory usage of your computer:</p>
 
   <steps>
-    <item><p>Click the <gui>Resources</gui> tab.</p>
+    <item>
+      <p>Click the <gui>Resources</gui> tab.</p>
     </item>
   </steps>
-  <list>
-    <item><p><gui>Memory and Swap History</gui> displays a running line graph
-    for memory and swap as a percentage of the total available. These are plotted
-    against time, with the current time at the right.</p>
-      <note style = "tip"><p>The color of each line is indicated by the pie
-      graphs below. Click the pie graph to change the color of the line graph.</p>
-      </note>
-    </item>
-    <item><p>The <gui>Memory</gui> pie graph shows memory usage in
-    <link xref="units">GiB</link> and as a percentage of the total available.</p>
-    </item>
-  </list>
+
+  <p><gui>Memory and Swap History</gui> displays a running line graph for
+  memory and swap as a percentage of the total available. These are plotted
+  against time, with the current time at the right.</p>
+
+  <note style="tip">
+    <p>The color of each line is indicated by the pie graphs below. Click the
+    pie graph to change the color of the line graph.</p>
+  </note>
+
+  <p>The <gui>Memory</gui> pie graph shows memory usage in
+  <link xref="units">GiB</link> and as a percentage of the total available.</p>
 
   <p>To change the <gui>update interval</gui>:</p>
 
-    <steps>
-      <item><p>Click
-        <guiseq><gui>System Monitor</gui><gui>Preferences</gui></guiseq>.</p>
-      </item>
-      <item><p>Click the <gui>Resources</gui> tab.</p></item>
-      <item><p>Enter a value for <gui>Update interval in seconds</gui>.</p>
-      </item>
-    </steps>
+  <steps>
+    <item>
+      <p>Click
+      <guiseq><gui>System Monitor</gui><gui>Preferences</gui></guiseq>.</p>
+    </item>
+    <item>
+      <p>Click the <gui>Resources</gui> tab.</p>
+    </item>
+    <item>
+      <p>Enter a value for <gui>Update interval in seconds</gui>.</p>
+    </item>
+  </steps>
 
 <section id="highusage">
-  <title></title>
+  <title>Which processes are using the most memory?</title>
 
   <p>To check which processes are using the most memory:</p>
 
@@ -87,4 +93,5 @@
     </item>
   </steps>
 </section>
+
 </page>
diff --git a/help/C/mem-swap.page b/help/C/mem-swap.page
index bb3417f..7e727d0 100644
--- a/help/C/mem-swap.page
+++ b/help/C/mem-swap.page
@@ -1,8 +1,9 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic" style="task"
       id="mem-swap">
+
   <info>
-    <revision version="0.2" pkgversion="3.11" date="2014-01-26" status="review"/>
+    <revision pkgversion="3.11" date="2014-01-28" status="final"/>
     <link type="guide" xref="index" group="memory" />
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
@@ -28,26 +29,32 @@
   <comment>
     <cite date="2011-06-18" href="mailto:philbull gmail com">Phil Bull</cite>
     <p>Explain what swap is and how it helps. Explain that the computer may run
- slowly if it's swapping too much.</p>
+    slowly if it's swapping too much.</p>
   </comment>
 
-  <p>Swap memory or <gui>swap space</gui> is the on-disk component of the virtual
- memory system. It is pre-configured as a <gui>swap partition</gui> or a
- <gui>swap file</gui> when Linux is first installed, but can also be added
- later.</p>
+  <p>Swap memory or <em>swap space</em> is the on-disk component of the virtual
+  memory system. It is pre-configured as a <em>swap partition</em> or a
+  <em>swap file</em> when Linux is first installed, but can also be added
+  later.</p>
 
- <note><p>Disk access is <em>very</em> slow compared to memory access. The
- system runs more slowly if there is excessive swapping, or <gui>thrashing</gui>,
- when the system is unable to find enough free memory. In this situation the only
- solution is to add more RAM.</p></note>
+  <note>
+    <p>Disk access is <em>very</em> slow compared to memory access. The system
+    runs more slowly if there is excessive swapping, or <em>thrashing</em>,
+    when the system is unable to find enough free memory. In this situation the
+    only solution is to add more RAM.</p>
+  </note>
 
-  <p>To see whether swapping, or <gui>paging</gui>, has become a performance
+  <p>To see whether swapping, or <em>paging</em>, has become a performance
   issue:</p>
 
   <steps>
-    <item><p>Click the <gui>Resources</gui> tab.</p></item>
-    <item><p>The <gui>Memory and Swap History</gui> graph shows memory and swap
- use as percentages.</p></item>
+    <item>
+      <p>Click the <gui>Resources</gui> tab.</p>
+    </item>
+    <item>
+      <p>The <gui>Memory and Swap History</gui> graph shows memory and swap use
+      as percentages.</p>
+    </item>
   </steps>
 
 </page>