GNOME.org
 

[gnome-user-docs/gnome-3-0] g-h/power-*: Some reviews and reorgs

commit 251e6317d74f531ea565baaa5c9863a48a789c82
Author: Shaun McCance <shaunm gnome org>
Date:   Mon May 30 17:24:47 2011 -0400

    g-h/power-*: Some reviews and reorgs

 gnome-help/C/power-batterybroken.page    |   13 +++++++++----
 gnome-help/C/power-batterylife.page      |    8 ++++----
 gnome-help/C/power-batteryoptimal.page   |    6 +++---
 gnome-help/C/power-closelid.page         |   24 +++++++++++++-----------
 gnome-help/C/power-constantfan.page      |    6 +++---
 gnome-help/C/power-hotcomputer.page      |    2 +-
 gnome-help/C/power-suspendhibernate.page |   19 ++++++++++---------
 gnome-help/C/power-willnotturnon.page    |    2 +-
 gnome-help/C/power.page                  |   12 ++++++++----
 9 files changed, 52 insertions(+), 40 deletions(-)
---
diff --git a/gnome-help/C/power-batterybroken.page b/gnome-help/C/power-batterybroken.page
index 07f975a..c6eb7a4 100644
--- a/gnome-help/C/power-batterybroken.page
+++ b/gnome-help/C/power-batterybroken.page
@@ -4,13 +4,13 @@
       id="power-batterybroken">
 
   <info>
-    <link type="guide" xref="power#battery"/>
+    <link type="guide" xref="power#problems"/>
     <link type="guide" xref="hardware#power"/>
     <link type="seealso" xref="power-batteryoptimal"/>
     
     <desc>Your battery is probably not broken; it's more likely that it's just old.</desc>
     <revision pkgversion="3.0" date="2011-04-04" status="final"/>
-    <revision pkgversion="3.0" version="3.0.1" date="2011-04-06" status="outdated"/>
+    <revision pkgversion="3.0" version="3.0.1" date="2011-05-30" status="final"/>
     
     <credit type="author">
       <name>GNOME Documentation Project</name>
@@ -20,7 +20,12 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-<title>Why does it say my battery is broken?</title>
+<title>An error reports my battery has low capacity</title>
+
+<comment>
+  <cite date="2011-05-30">shaunm</cite>
+  <p>Let's see if we can get that dialog to have a help button pointing here.</p>
+</comment>
 
 <p>When you first log in, you might see a message that says:</p>
 <quote>
@@ -31,6 +36,6 @@
 
 <p>Over time, all laptop batteries lose their ability to store charge. After a while (normally a year or more), the battery will only be able to store a fraction of the charge that it could when it was new. The message above is shown when this happens.</p>
 
-<p>If your computer/battery is relatively new, it should be capable of holding a high percentage of its design charge. If it can't, then your battery may be broken and you might need to seek a replacement.</p>
+<p>If your computer or battery is relatively new, it should be capable of holding a high percentage of its design charge. If it can't, then your battery may be broken and you might need to seek a replacement.</p>
 
 </page>
diff --git a/gnome-help/C/power-batterylife.page b/gnome-help/C/power-batterylife.page
index c9a923f..2a54daf 100644
--- a/gnome-help/C/power-batterylife.page
+++ b/gnome-help/C/power-batterylife.page
@@ -4,13 +4,13 @@
       id="power-batterylife">
 
   <info>
-    <link type="guide" xref="power#battery"/>
+    <link type="guide" xref="power"/>
     <link type="seealso" xref="power-suspendhibernate"/>
     
     <desc>Tips to reduce your computer's power consumption.</desc>
     
     <revision pkgversion="3.0" date="2011-04-04" status="final"/>
-    <revision pkgversion="3.0" version="3.0.1" date="2011-04-06" status="outdated"/>
+    <revision pkgversion="3.0" version="3.0.1" date="2011-05-30" status="final"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -23,14 +23,14 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-<title>How can I use less power and improve battery life?</title>
+<title>Use less power and improve battery life</title>
 
 <p>Computers can use a lot of power. By using some simple energy-saving strategies, you can reduce your energy bill and help the environment. If you have a laptop, this will also help to increase the amount of time it can run on battery for.</p>
 
 <section id="general">
+ <list>
  <title>General tips</title>
 
- <list>
   <item>
    <p><link xref="shell-exit#suspend">Suspend your computer</link> when you are not using it. This significantly reduces the amount of power it uses, and it can be woken up very quickly.</p>
   </item>
diff --git a/gnome-help/C/power-batteryoptimal.page b/gnome-help/C/power-batteryoptimal.page
index 1f1c153..d3ce6ea 100644
--- a/gnome-help/C/power-batteryoptimal.page
+++ b/gnome-help/C/power-batteryoptimal.page
@@ -4,12 +4,12 @@
       id="power-batteryoptimal">
 
   <info>
-    <link type="guide" xref="power#battery"/>
+    <link type="guide" xref="power"/>
     
-    <desc>Don't let the battery run down too far.</desc>
+    <desc>Don't let the battery run down too far and other tips.</desc>
     
     <revision pkgversion="3.0" date="2011-04-04" status="final"/>
-    <revision pkgversion="3.0" version="3.0.1" date="2011-04-06" status="outdated"/>
+    <revision pkgversion="3.0" version="3.0.1" date="2011-05-30" status="final"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
diff --git a/gnome-help/C/power-closelid.page b/gnome-help/C/power-closelid.page
index 8e4e74d..6c2faad 100644
--- a/gnome-help/C/power-closelid.page
+++ b/gnome-help/C/power-closelid.page
@@ -1,15 +1,15 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic"
+      type="topic" style="question"
       id="power-closelid">
 
   <info>
-    <link type="guide" xref="power#problems"/>
+    <link type="guide" xref="power"/>
     <link type="guide" xref="hardware#power"/>
     <link type="seealso" xref="power-suspendfail"/>
     
     <desc>Laptops go to sleep when you close the lid, in order to save power.</desc>
     <revision pkgversion="3.0" date="2011-04-04" status="final"/>
-    <revision pkgversion="3.0" version="3.0.1" date="2011-04-06" status="outdated"/>
+    <revision pkgversion="3.0" version="3.0.1" date="2011-05-30" status="final"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -27,20 +27,22 @@
 <section id="nosuspend">
  <title>Stop the computer from suspending when the lid is closed</title>
  <p>If you don't want the computer to suspend when you close the lid, you can change the settings for that behavior.  To set the computer to blank the screen, rather than suspend, when the lid is closed:</p>
+ <note style="warning">
+   <p>Be very careful if you change this setting. Some laptops can overheat
+   if they are left running with the lid closed, especially if they are in
+   a confined place like a backpack.</p>
+ </note>
  <steps>
    <item>
-     <p>Move your mouse to the Activities menu to activate the overview.</p>
+     <p>Open the <app>Terminal</app> application from the <gui>Activities</gui> overview.</p>
    </item>
    <item>
-     <p>Choose <gui>Applications</gui> and locate the Terminal in the list, or type "terminal" to locate it.  Click the <gui>Terminal</gui> icon to start the application.</p>
+     <p>To change the setting used when running on battery power, type this command and press <key>Enter</key>:</p>
+     <screen>gsettings set org.gnome.settings-daemon.plugin.power lid-close-battery-action blank</screen>
    </item>
    <item>
-     <p>To change the setting used when running on battery power, type this command and hit <key>Enter</key>:</p>
-     <code>gsettings set org.gnome.settings-daemon.plugin.power lid-close-battery-action blank</code>
-   </item>
-   <item>
-     <p>To change the setting used when running on AC power, type this command and hit <key>Enter</key>:</p>
-     <code>gsettings set org.gnome.settings-daemon.plugin.power lid-close-ac-action blank</code>
+     <p>To change the setting used when running on AC power, type this command and press <key>Enter</key>:</p>
+     <screen>gsettings set org.gnome.settings-daemon.plugin.power lid-close-ac-action blank</screen>
    </item>
  </steps>
  <p>There are other settings available besides "blank," such as "nothing," which causes the computer to do nothing.</p>
diff --git a/gnome-help/C/power-constantfan.page b/gnome-help/C/power-constantfan.page
index a8abd2d..8ad1c1c 100644
--- a/gnome-help/C/power-constantfan.page
+++ b/gnome-help/C/power-constantfan.page
@@ -1,5 +1,5 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic"
+      type="topic" style="problem"
       id="power-constantfan">
 
   <info>
@@ -8,7 +8,7 @@
     <desc>Some fan-control software could be missing, or your laptop may be running hot.</desc>
     
     <revision pkgversion="3.0" date="2011-04-04" status="final"/>
-    <revision pkgversion="3.0" version="3.0.1" date="2011-04-06" status="outdated"/>
+    <revision pkgversion="3.0" version="3.0.1" date="2011-05-30" status="final"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -17,7 +17,7 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-<title>Why is the laptop fan always running?</title>
+<title>The laptop fan is always running</title>
 
 <p>If your laptop's cooling fan is always running, it could be that the hardware that controls the laptop's cooling system isn't very well supported in Linux. Some laptops need extra software to control their cooling fans efficiently, but this software may not be installed (or available for Linux at all) and so the fans just run at full speed all of the time.</p>
 
diff --git a/gnome-help/C/power-hotcomputer.page b/gnome-help/C/power-hotcomputer.page
index 97f3867..f64c4ce 100644
--- a/gnome-help/C/power-hotcomputer.page
+++ b/gnome-help/C/power-hotcomputer.page
@@ -7,7 +7,7 @@
     <link type="guide" xref="power#problems"/>
     <desc>Computers usually get warm, but if they get too hot they can overheat, which can be damaging.</desc>
     <revision pkgversion="3.0" date="2011-04-04" status="final"/>
-    <revision pkgversion="3.0" version="3.0.1" date="2011-04-06" status="outdated"/>
+    <revision pkgversion="3.0" version="3.0.1" date="2011-05-30" status="final"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
diff --git a/gnome-help/C/power-suspendhibernate.page b/gnome-help/C/power-suspendhibernate.page
index b2cd183..9ca3299 100644
--- a/gnome-help/C/power-suspendhibernate.page
+++ b/gnome-help/C/power-suspendhibernate.page
@@ -1,15 +1,15 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic"
+      type="topic" style="question"
       id="power-suspendhibernate">
 
   <info>
-    <link type="guide" xref="power#problems"/>
+    <link type="guide" xref="power"/>
     <link type="guide" xref="hardware#power"/>
     
     <desc>Suspend sends it to sleep; hibernate saves your files but completely switches off the power.</desc>
     
     <revision pkgversion="3.0" date="2011-04-04" status="final"/>
-    <revision pkgversion="3.0" version="3.0.1" date="2011-04-06" status="outdated"/>
+    <revision pkgversion="3.0" version="3.0.1" date="2011-05-30" status="incomplete"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -18,14 +18,15 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-<title>What happens when I suspend/hibernate the computer?</title>
+<title>What happens when I suspend or hibernate the computer?</title>
 
 <comment>
-  <cite date="2011-04-04">shaunm</cite>
-  <p>Marking final for 3.0. Would like a slightly better explanation on what
-  "saved to disk" means for hibernate. As written, could be confused with open
-  files being saved, which they aren't, per se. Link to topics on controlling
-  suspend/hibernate behavior.</p>
+  <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
+  GNOME 3, we barely expose hibernate. It's in the power settings, but nothing
+  does it by default. Restructure prose to reflect that.</p>
+  <p>This page stays incomplete until this is dealt with.</p>
 </comment>
 
 <p>When you <em>suspend</em> the computer, you send it to sleep. All of your applications and documents remain open, but the screen and other parts of the computer switch off to save power. The computer is still switched on though, and it will still be using a small amount of power. You can wake it up by pressing a key or clicking the mouse. If that doesn't work, try pressing the power button.</p>
diff --git a/gnome-help/C/power-willnotturnon.page b/gnome-help/C/power-willnotturnon.page
index e3aa4e1..ccef579 100644
--- a/gnome-help/C/power-willnotturnon.page
+++ b/gnome-help/C/power-willnotturnon.page
@@ -8,7 +8,7 @@
     
     <desc>Loose cables and hardware problems are possible reasons.</desc>
     <revision pkgversion="3.0" date="2011-04-03" status="final"/>
-    <revision pkgversion="3.0" version="3.0.1" date="2011-04-06" status="outdated"/>
+    <revision pkgversion="3.0" version="3.0.1" date="2011-05-30" status="final"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
diff --git a/gnome-help/C/power.page b/gnome-help/C/power.page
index 3ed357b..ec121db 100644
--- a/gnome-help/C/power.page
+++ b/gnome-help/C/power.page
@@ -22,14 +22,18 @@
     
 </info>
 
-<title>Power settings</title>
+<title>Power &amp; battery</title>
 
 <section id="battery" style="2column">
-    <title>Battery settings</title>
+  <title>Battery settings</title>
 </section>
 
-<section id="problems" style="2column">
-    <title>Problems</title>
+<section id="problems" style="linklist nodesc">
+  <info>
+    <title type="link">Power problems</title>
+    <desc>Troubleshoot problems with power and batteries.</desc>
+  </info>
+  <title>Problems</title>
 </section>
 
 </page>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]