[gnome-system-monitor/mallard-help: 2/30] First draft: net-bits, solaris, units, priority-what

[David King <davidk src gnome org>]

commit 537243871ce39468cd336e6b1f02178e2bf0d3b0
Author: Mike Hill <mdhillca gmail com>
Date:   Thu Jun 23 18:21:59 2011 -0400

    First draft: net-bits, solaris, units, priority-what

 help/C/net-bits.page              |   14 +++++++++-----
 help/C/process-priority-what.page |   21 +++++++++++++--------
 help/C/solaris-mode.page          |   18 ++++++++++++------
 help/C/units.page                 |   22 +++++++++++++++-------
 4 files changed, 49 insertions(+), 26 deletions(-)
---
diff --git a/help/C/net-bits.page b/help/C/net-bits.page
index 520e6b5..b176001 100644
--- a/help/C/net-bits.page
+++ b/help/C/net-bits.page
@@ -11,7 +11,8 @@
       <years>2011</years>
     </credit>
 
-    <desc>Click <guiseq><gui>Edit</gui><gui>Preferences</gui></guiseq> and check the option in the 
<gui>Resources</gui> tab.</desc>
+    <desc>Click <guiseq><gui>Edit</gui><gui>Preferences</gui></guiseq> and
+ check the option in the <gui>Resources</gui> tab.</desc>
   </info>
 
   <title>Show the network speed in bits instead of bytes per second</title>
@@ -21,12 +22,15 @@
     <p>Brief topic. Explain how to do this, and why you might want to do it.</p>
   </comment>
 
-  <p>Short introductory text...</p>
+  <p>Network speed is often shown in bits per second, rather than bytes per
+ second. This is called the <em>bit rate</em>, or <em>data rate</em>.</p>
+
+  <p>To display the network speed in bits:</p>
 
   <steps>
-    <item><p>First step...</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
+    <item><p>Click <guiseq><gui>Edit</gui><gui>Preferences</gui></guiseq>.</p></item>
+    <item><p>Click the <gui>Resources</gui> tab.</p></item>
+    <item><p>Select <gui>Show network speed in bits</gui>.</p></item>
   </steps>
 
 </page>
diff --git a/help/C/process-priority-what.page b/help/C/process-priority-what.page
index 97696d7..1a9782d 100644
--- a/help/C/process-priority-what.page
+++ b/help/C/process-priority-what.page
@@ -11,22 +11,27 @@
       <years>2011</years>
     </credit>
 
-    <desc>XXXXX</desc>
+    <desc>The Nice value of a process is used to adjust its priority</desc>
   </info>
 
   <title>Process priority and 'nice' levels</title>
 
   <comment>
     <cite date="2011-06-18" href="mailto:philbull gmail com">Phil Bull</cite>
-    <p>Explain, in brief and simple terms, what nice levels are, why they are used, and how process 
scheduling works (Wikipedia article on nice is good for this.)</p>
+    <p>Explain, in brief and simple terms, what nice levels are, why they are
+ used, and how process scheduling works (Wikipedia article on nice is good for
+ this.)</p>
+    <cite date="2011-06-23" href="mailto:mdhillca gmail com">Mike Hill</cite>
+    <p>Needs to be simpler.</p>
   </comment>
 
-  <p>Short introductory text...</p>
+  <p>A multitasking system's processes are alotted time on the processor (CPU)
+ by the kernel scheduler. A 'nice' process, or one with a higher nice value,
+ concedes priority to other processes. Adjusting the nice value will increase
+ or decrease the scheduling priority.</p>
 
-  <steps>
-    <item><p>First step...</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
-  </steps>
+  <p>The lower the nice value, the higher the priority of the process. The nice
+ value ranges from -20 (low nice, higher priority) to 20 (lower priority). The
+ default value of nice is usually 0.</p>
 
 </page>
diff --git a/help/C/solaris-mode.page b/help/C/solaris-mode.page
index 1dcf063..0815dad 100644
--- a/help/C/solaris-mode.page
+++ b/help/C/solaris-mode.page
@@ -11,22 +11,28 @@
       <years>2011</years>
     </credit>
 
-    <desc>XXXX</desc>
+    <desc>Use Solaris mode to reflect the number of CPUs</desc>
   </info>
 
   <title>What is Solaris mode?</title>
 
   <comment>
     <cite date="2011-06-18" href="mailto:philbull gmail com">Phil Bull</cite>
-    <p>Very brief topic. Explain what "Solaris mode" in the preferences dialog means. The current manual has 
some information.</p>
+    <p>Very brief topic. Explain what "Solaris mode" in the preferences dialog
+ means. The current manual has some information.</p>
   </comment>
 
-  <p>Short introductory text...</p>
+  <p>In a system that has multiple CPUs, it is possible for the <gui>% CPU</gui>
+ column to display values that total greater than 100% (i.e. 400% in a 4-CPU
+ system). <gui>Solaris mode</gui> divides the <gui>% CPU</gui> for each process
+ by the number of CPUs in the system so that the total will be 100%.</p>
+
+  <p>To display the <gui>% CPU</gui> in <gui>Solaris mode</gui>:</p>
 
   <steps>
-    <item><p>First step...</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
+    <item><p>Click <guiseq><gui>Edit</gui><gui>Preferences</gui></guiseq>.</p></item>
+    <item><p>Click the <gui>Processes</gui> tab.</p></item>
+    <item><p>Select <gui>Solaris mode</gui>.</p></item>
   </steps>
 
 </page>
diff --git a/help/C/units.page b/help/C/units.page
index a15dd9c..c9f7832 100644
--- a/help/C/units.page
+++ b/help/C/units.page
@@ -11,7 +11,7 @@
       <years>2011</years>
     </credit>
 
-    <desc>XXXXX</desc>
+    <desc>Units of measure for memory and disk space</desc>
   </info>
 
   <title>Is GiB the same as GB (gigabyte)?</title>
@@ -21,12 +21,20 @@
     <p>Answer this question, quite briefly.</p>
   </comment>
 
-  <p>Short introductory text...</p>
+    <p>The memory and disk space statistics are displayed using <em>IEC binary
+ prefixes</em>, KiB, MiB, GiB, TiB (for kibi, mebi, gibi and tebi). These are
+ intended to distinguish binary reporting of sizes used in System Monitor
+ (multiples of 1024) from decimal sizes (multiples of 1000) commonly used, for
+ instance, in packaging of hard disks.</p>
 
-  <steps>
-    <item><p>First step...</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
-  </steps>
+    <p>Typical binary units:</p>
+  <list>
+    <item><p>1 KiB =       1024 bytes</p></item>
+    <item><p>1 MiB =    1048576 bytes</p></item>
+    <item><p>1 GiB = 1073741842 bytes</p></item>
+  </list>
+
+    <p>An external hard drive, advertised as 1.0 TB (terabytes), would display
+ as 0.909 TiB (tebibytes).</p>
 
 </page>