[gnome-user-docs] power: Marked most final, added comments, needs some work



commit 792f9d81ea64631454ba7d0839fbee8ec6d59f84
Author: Shaun McCance <shaunm gnome org>
Date:   Mon Sep 26 19:23:57 2011 -0400

    power: Marked most final, added comments, needs some work

 gnome-help/C/bluetooth.page                        |    1 -
 gnome-help/C/hardware-cardreader.page              |    1 +
 gnome-help/C/power-batterybroken.page              |    8 +++++---
 gnome-help/C/power-batteryestimate.page            |    1 +
 gnome-help/C/power-batterylife.page                |    1 +
 gnome-help/C/power-batteryoptimal.page             |    1 +
 gnome-help/C/power-batteryslow.page                |    1 +
 gnome-help/C/power-batterywindows.page             |    1 +
 gnome-help/C/power-brighter.page                   |    1 +
 gnome-help/C/power-closelid.page                   |    1 +
 gnome-help/C/power-constantfan.page                |    1 +
 gnome-help/C/power-hotcomputer.page                |    1 +
 gnome-help/C/power-lowpower.page                   |    1 +
 gnome-help/C/power-nowireless.page                 |    1 +
 gnome-help/C/power-othercountry.page               |    1 +
 gnome-help/C/power-suspendfail.page                |    5 +++--
 gnome-help/C/power-suspendhibernate.page           |    8 +++++++-
 ...offbutton.page => power-turnoffbutton.page.old} |    0
 gnome-help/C/power-whydim.page                     |    3 ++-
 gnome-help/C/power-willnotturnon.page              |    1 +
 gnome-help/C/power.page                            |    7 +++++++
 gnome-help/C/shell-exit.page                       |    3 +++
 gnome-help/Makefile.am                             |    1 -
 23 files changed, 41 insertions(+), 9 deletions(-)
---
diff --git a/gnome-help/C/bluetooth.page b/gnome-help/C/bluetooth.page
index cf5b365..dcd8f19 100644
--- a/gnome-help/C/bluetooth.page
+++ b/gnome-help/C/bluetooth.page
@@ -45,7 +45,6 @@ a new top-level guide for security, and link the topic there too.</p>
 <section id="problems">
   <info>
     <title type="link">Bluetooth problems</title>
-    <title type="link" role="trail">Problems</title>
     <link type="guide" xref="hardware#problems"/>
   </info>
   <title>Problems</title>
diff --git a/gnome-help/C/hardware-cardreader.page b/gnome-help/C/hardware-cardreader.page
index 8f5746e..c7c258b 100644
--- a/gnome-help/C/hardware-cardreader.page
+++ b/gnome-help/C/hardware-cardreader.page
@@ -1,5 +1,6 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic"
+      style="problem"
       id="hardware-cardreader">
 
   <info>
diff --git a/gnome-help/C/power-batterybroken.page b/gnome-help/C/power-batterybroken.page
index 332dbc2..bef9cbd 100644
--- a/gnome-help/C/power-batterybroken.page
+++ b/gnome-help/C/power-batterybroken.page
@@ -6,6 +6,8 @@
   <info>
     <link type="guide" xref="power#problems"/>
     <link type="seealso" xref="power-batteryoptimal"/>
+
+    <revision pkgversion="3.2" date="2011-09-26" status="final"/>
     
     <desc>Your battery is probably not broken; it's more likely that it is too old to hold charge.</desc>
     
@@ -25,9 +27,9 @@
 </comment>
 
 <p>When you first log in, you might see a message that says:</p>
-<quote>
- <p><em>Battery may be broken. Your battery has a very low capacity which means that it may be old or broken.</em></p>
-</quote>
+<example>
+ <p>Battery may be broken. Your battery has a very low capacity which means that it may be old or broken.</p>
+</example>
 
 <p>This message is displayed when the computer detects that your battery is not capable of storing much charge. The most likely reason for this is that your battery is old. If this is the case, there will be no damage to your computer or hardware.</p>
 
diff --git a/gnome-help/C/power-batteryestimate.page b/gnome-help/C/power-batteryestimate.page
index b5796cf..bde91b3 100644
--- a/gnome-help/C/power-batteryestimate.page
+++ b/gnome-help/C/power-batteryestimate.page
@@ -5,6 +5,7 @@
   <info>
   
     <link type="guide" xref="power#battery"/>
+    <revision pkgversion="3.2" date="2011-09-26" status="final"/>
     
     <desc>The battery life that is displayed is only an estimate.</desc>
     
diff --git a/gnome-help/C/power-batterylife.page b/gnome-help/C/power-batterylife.page
index c5c4563..98ec7b9 100644
--- a/gnome-help/C/power-batterylife.page
+++ b/gnome-help/C/power-batterylife.page
@@ -5,6 +5,7 @@
   <info>
     <link type="guide" xref="power"/>
     <link type="seealso" xref="power-suspendhibernate"/>
+    <revision pkgversion="3.2" date="2011-09-26" status="final"/>
     
     <desc>Tips to reduce your computer's power consumption.</desc>
     
diff --git a/gnome-help/C/power-batteryoptimal.page b/gnome-help/C/power-batteryoptimal.page
index a5be298..bf0a529 100644
--- a/gnome-help/C/power-batteryoptimal.page
+++ b/gnome-help/C/power-batteryoptimal.page
@@ -5,6 +5,7 @@
 
   <info>
     <link type="guide" xref="power"/>
+    <revision pkgversion="3.2" date="2011-09-26" status="final"/>
     
     <desc>Tips such as "Don't let the battery charge get too low"</desc>
     
diff --git a/gnome-help/C/power-batteryslow.page b/gnome-help/C/power-batteryslow.page
index 8dcba41..9fd1c2f 100644
--- a/gnome-help/C/power-batteryslow.page
+++ b/gnome-help/C/power-batteryslow.page
@@ -6,6 +6,7 @@
     <link type="guide" xref="power#battery"/>
     <desc>Some laptops intentionally slow down when they are running on battery.</desc>
     
+    <revision pkgversion="3.2" date="2011-09-26" status="final"/>
     
     <credit type="author">
       <name>GNOME Documentation Project</name>
diff --git a/gnome-help/C/power-batterywindows.page b/gnome-help/C/power-batterywindows.page
index 6ad288d..8d6e08a 100644
--- a/gnome-help/C/power-batterywindows.page
+++ b/gnome-help/C/power-batterywindows.page
@@ -4,6 +4,7 @@
 
   <info>
     <link type="guide" xref="power#battery"/>
+    <revision pkgversion="3.2" date="2011-09-26" status="final"/>
     <desc>Tweaks from the manufacturer and differing battery life estimates may be the cause of this problem.</desc>
     <credit type="author">
       <name>GNOME Documentation Project</name>
diff --git a/gnome-help/C/power-brighter.page b/gnome-help/C/power-brighter.page
index f1a1f96..cf7e600 100644
--- a/gnome-help/C/power-brighter.page
+++ b/gnome-help/C/power-brighter.page
@@ -7,6 +7,7 @@
     <link type="guide" xref="hardware-problems-graphics"/>
     <link type="seealso" xref="power-whydim"/>
     <link type="seealso" xref="display-dimscreen"/>
+    <revision pkgversion="3.2" date="2011-09-26" status="final"/>
     
     <desc>Laptops and desktop monitors usually have buttons that you can press to change the brightness.</desc>
     <credit type="author">
diff --git a/gnome-help/C/power-closelid.page b/gnome-help/C/power-closelid.page
index 8c470da..a5bdd21 100644
--- a/gnome-help/C/power-closelid.page
+++ b/gnome-help/C/power-closelid.page
@@ -5,6 +5,7 @@
   <info>
     <link type="guide" xref="power"/>
     <link type="seealso" xref="power-suspendfail"/>
+    <revision pkgversion="3.2" date="2011-09-26" status="final"/>
     
     <desc>Laptops go to sleep when you close the lid, in order to save power.</desc>
     <credit type="author">
diff --git a/gnome-help/C/power-constantfan.page b/gnome-help/C/power-constantfan.page
index d509fc3..ba9bf80 100644
--- a/gnome-help/C/power-constantfan.page
+++ b/gnome-help/C/power-constantfan.page
@@ -4,6 +4,7 @@
 
   <info>
     <link type="guide" xref="power#problems"/>
+    <revision pkgversion="3.2" date="2011-09-26" status="final"/>
     
     <desc>Some fan-control software could be missing, or your laptop may be running hot.</desc>
     
diff --git a/gnome-help/C/power-hotcomputer.page b/gnome-help/C/power-hotcomputer.page
index 0ae9b60..4be058b 100644
--- a/gnome-help/C/power-hotcomputer.page
+++ b/gnome-help/C/power-hotcomputer.page
@@ -5,6 +5,7 @@
 
   <info>
     <link type="guide" xref="power#problems"/>
+    <revision pkgversion="3.2" date="2011-09-26" status="final"/>
     <desc>Computers usually get warm, but if they get too hot they can overheat, which can be damaging.</desc>
     <credit type="author">
       <name>GNOME Documentation Project</name>
diff --git a/gnome-help/C/power-lowpower.page b/gnome-help/C/power-lowpower.page
index a63ba08..8906a48 100644
--- a/gnome-help/C/power-lowpower.page
+++ b/gnome-help/C/power-lowpower.page
@@ -4,6 +4,7 @@
 
   <info>
     <link type="guide" xref="power#battery"/>
+    <revision pkgversion="3.2" date="2011-09-26" status="final"/>
     <desc>Allowing the battery to completely discharge is bad for it.</desc>
     <credit type="author">
       <name>GNOME Documentation Project</name>
diff --git a/gnome-help/C/power-nowireless.page b/gnome-help/C/power-nowireless.page
index 09c10e9..15c757a 100644
--- a/gnome-help/C/power-nowireless.page
+++ b/gnome-help/C/power-nowireless.page
@@ -7,6 +7,7 @@
     <link type="guide" xref="power#problems"/>
     <link type="seealso" xref="power-suspendfail"/>
     
+    <revision pkgversion="3.2" date="2011-09-26" status="final"/>
     <desc>Some wireless devices have problems handling when your computer is sent to sleep and don't wake up again properly.</desc>
     <credit type="author">
       <name>GNOME Documentation Project</name>
diff --git a/gnome-help/C/power-othercountry.page b/gnome-help/C/power-othercountry.page
index a4f5323..e273703 100644
--- a/gnome-help/C/power-othercountry.page
+++ b/gnome-help/C/power-othercountry.page
@@ -6,6 +6,7 @@
     <link type="guide" xref="power#problems"/>
     <desc>Your computer will work, but you might need a different power cable or a travel adapter.</desc>
     
+    <revision pkgversion="3.2" date="2011-09-26" status="final"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
diff --git a/gnome-help/C/power-suspendfail.page b/gnome-help/C/power-suspendfail.page
index 56ac49d..9409970 100644
--- a/gnome-help/C/power-suspendfail.page
+++ b/gnome-help/C/power-suspendfail.page
@@ -5,6 +5,7 @@
   <info>
     <link type="guide" xref="power#problems"/>
     <link type="guide" xref="hardware-problems-graphics"/>
+    <revision pkgversion="3.2" date="2011-09-26" status="incomplete"/>
     
     <desc>Some computer hardware causes problems with suspend/hibernate.</desc>
     
@@ -19,8 +20,8 @@
 <title>Why won't my computer turn back on after I sent it to sleep?</title>
 
 <comment>
-  <cite date="2011-04-04">shaunm</cite>
-  <p>Marked incomplete as of 2011-04-04. Marking final for 3.0. Revisit for 3.2</p>
+  <cite date="2011-09-26">shaunm</cite>
+  <p>Standard terminology is suspend. Instances of sleep are bugs.</p>
 </comment>
 
 <p>If you send your computer to sleep (suspend it) or hibernate it, then try to wake it up or turn it back on, you may find that it doesn't work as you expected. This could be because suspend/hibernate aren't supported properly by your hardware.</p>
diff --git a/gnome-help/C/power-suspendhibernate.page b/gnome-help/C/power-suspendhibernate.page
index 0d24511..5342063 100644
--- a/gnome-help/C/power-suspendhibernate.page
+++ b/gnome-help/C/power-suspendhibernate.page
@@ -6,7 +6,8 @@
     <link type="guide" xref="power"/>
     
     <desc>Suspend sends it to sleep; hibernate saves your files but completely switches off the power.</desc>
-    
+    <revision pkgversion="3.2" date="2011-09-26" status="incomplete"/>
+
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -18,6 +19,11 @@
 <title>What happens when I suspend or hibernate the computer?</title>
 
 <comment>
+  <cite date="2011-09-26">shaunm</cite>
+  <p>Standard terminology is suspend. Instances of sleep are bugs.</p>
+</comment>
+
+<comment>
   <cite date="2011-05-30">shaunm</cite>
   <p>I would like a better explanation of what "saved to disk" means. As written,
   it could be confused with open files being saved, which they aren't. Also, with
diff --git a/gnome-help/C/power-turnoffbutton.page b/gnome-help/C/power-turnoffbutton.page.old
similarity index 100%
rename from gnome-help/C/power-turnoffbutton.page
rename to gnome-help/C/power-turnoffbutton.page.old
diff --git a/gnome-help/C/power-whydim.page b/gnome-help/C/power-whydim.page
index 099486f..5001162 100644
--- a/gnome-help/C/power-whydim.page
+++ b/gnome-help/C/power-whydim.page
@@ -1,10 +1,11 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic" style="task"
+      type="topic"
       id="power-whydim">
 
   <info>
     <link type="guide" xref="power#battery"/>
     <link type="guide" xref="hardware-problems-graphics"/>
+    <revision pkgversion="3.2" date="2011-09-26" status="final"/>
     
     <desc>When your laptop is running on battery, the screen will dim when the computer is idle in order to save power.</desc>
     <credit type="author">
diff --git a/gnome-help/C/power-willnotturnon.page b/gnome-help/C/power-willnotturnon.page
index 4871697..fa09de0 100644
--- a/gnome-help/C/power-willnotturnon.page
+++ b/gnome-help/C/power-willnotturnon.page
@@ -5,6 +5,7 @@
   <info>
     <link type="guide" xref="power#problems"/>
     <link type="guide" xref="hardware-problems-graphics" group="#last"/>
+    <revision pkgversion="3.2" date="2011-09-26" status="final"/>
     
     <desc>Loose cables and hardware problems are possible reasons.</desc>
     <credit type="author">
diff --git a/gnome-help/C/power.page b/gnome-help/C/power.page
index c379b13..f788291 100644
--- a/gnome-help/C/power.page
+++ b/gnome-help/C/power.page
@@ -5,6 +5,7 @@
     <link type="guide" xref="prefs"/>
     <link type="guide" xref="hardware" />
     
+    <revision pkgversion="3.2" date="2011-09-26" status="review"/>
     
     <credit type="author">
       <name>Natalia Ruz</name>
@@ -22,6 +23,11 @@
 
 <title>Power &amp; battery</title>
 
+<comment>
+<cite date="2011-09-26">shaunm</cite>
+<p>Could use some organization work</p>
+</comment>
+
 <section id="battery" style="2column">
   <title>Battery settings</title>
 </section>
@@ -29,6 +35,7 @@
 <section id="problems" style="linklist nodesc">
   <info>
     <title type="link">Power problems</title>
+    <link type="guide" xref="hardware#problems"/>
     <desc>Troubleshoot problems with power and batteries.</desc>
   </info>
   <title>Problems</title>
diff --git a/gnome-help/C/shell-exit.page b/gnome-help/C/shell-exit.page
index f610f5f..43fa9d8 100644
--- a/gnome-help/C/shell-exit.page
+++ b/gnome-help/C/shell-exit.page
@@ -79,7 +79,10 @@
 
 <section id="shutdown">
 <info>
+<!--
+  excised:
   <link type="seealso" xref="power-turnoffbutton"/>
+-->
 </info>
 <title>Shut down or restart</title>
 
diff --git a/gnome-help/Makefile.am b/gnome-help/Makefile.am
index 801d54e..3e1f228 100644
--- a/gnome-help/Makefile.am
+++ b/gnome-help/Makefile.am
@@ -222,7 +222,6 @@ HELP_FILES = \
 	power-othercountry.page \
 	power-suspendfail.page \
 	power-suspendhibernate.page \
-	power-turnoffbutton.page \
 	power-whydim.page \
 	power-willnotturnon.page \
 	power.page \



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