[gnome-user-docs] Write several stub topics in power-



commit 12525949e9617e99e380580ab23e536b4d285a4a
Author: Phil Bull <philbull gmail com>
Date:   Sat Mar 19 14:35:54 2011 -0400

    Write several stub topics in power-

 gnome-help/C/power-batteryslow.page                |   18 ++++++--------
 gnome-help/C/power-brighter.page                   |   24 +++++++++++--------
 gnome-help/C/power-closelid.page                   |   19 ++++++++++++---
 .../{power-history.page => power-history.page.old} |    9 +++++--
 gnome-help/C/power-lowpower.page                   |   14 ++++++++---
 5 files changed, 53 insertions(+), 31 deletions(-)
---
diff --git a/gnome-help/C/power-batteryslow.page b/gnome-help/C/power-batteryslow.page
index 673f70c..ff68efc 100644
--- a/gnome-help/C/power-batteryslow.page
+++ b/gnome-help/C/power-batteryslow.page
@@ -1,12 +1,11 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      xmlns:e="http://projectmallard.org/experimental/";
       type="topic"
       id="power-batteryslow">
 
   <info>
     <link type="guide" xref="power#battery"/>
-    <desc>XXX</desc>
-    <revision pkgversion="0.1" version="0.1" date="2010-06-29" status="stub"/>
+    <desc>Some laptops intentionally slow down when they are running on battery.</desc>
+    <revision pkgversion="0.1" version="0.1" date="2011-03-19" status="review"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -15,11 +14,10 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>Why is my laptop slow when it's on battery?</title>
-  
-  <comment>
-   <cite date="2010-06-29" href="mailto:gnome-doc-list gnome org">GNOME Documentation Project</cite>
-   <p>On battery, processors with variable clock speeds may go into powersaving mode, which is slower. Explain this, and how the settings can be changed.</p>
-  </comment>
-	
+<title>Why is my laptop slow when it's on battery?</title>
+
+<p>Some laptops intentionally slow down when they are running on battery in order to conserve power. The laptop's processor (CPU) switches to a slower speed, and processors use less power when running slower, so the battery should last longer.</p>
+
+<p>This feature is called <em>CPU frequency scaling</em>.</p>
+
 </page>
diff --git a/gnome-help/C/power-brighter.page b/gnome-help/C/power-brighter.page
index 3046b4d..8e411ec 100644
--- a/gnome-help/C/power-brighter.page
+++ b/gnome-help/C/power-brighter.page
@@ -1,12 +1,13 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      xmlns:e="http://projectmallard.org/experimental/";
       type="topic"
       id="power-brighter">
 
   <info>
     <link type="guide" xref="power#problems"/>
-    <desc>XXX</desc>
-    <revision pkgversion="0.1" version="0.1" date="2010-06-29" status="stub"/>
+    <link type="seealso" xref="power-whydim"/>
+    
+    <desc>Laptops and desktop monitors usually have buttons that you can press to change the brightness.</desc>
+    <revision pkgversion="0.1" version="0.1" date="2011-03-19" status="review"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -15,11 +16,14 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>How can I make the screen brighter?</title>
-  
-  <comment>
-   <cite date="2010-06-29" href="mailto:gnome-doc-list gnome org">GNOME Documentation Project</cite>
-   <p>Explain that most laptops have a brightness control using a keyboard shortcut. Mention the panel applet that allows you to control screen brightness. Mention places where screen brightness behaviour can be changed (link to other topics if necessary). For people with desktop displays, mention that there is normally a brightness control on the monitor. Also, mention that the screen gamma/contrast settings may have an impact on perceived brightness.</p>
-  </comment>
-	
+<title>How can I make the screen brighter?</title>
+
+<p>If you have a laptop or netbook, there are probably some screen brightness controls on the keyboard. They usually have stylized "sun" icons, and are often on or above the function keys (e.g. <key>F4</key>). On some laptops, you must hold-down the Function (<key>Fn</key>) key and then press one of the brightness keys to change the screen brightness. For example, you might press <keyseq><key>Fn</key><key>F4</keyseq> to decrease the brightness and <keyseq><key>Fn</key><key>F5</keyseq> to increase it.</p>
+
+<p>You can also change the brightness by clicking your name on the top panel, selecting <gui>System Settings</gui> and then opening the <gui>Screen</gui> preferences.</p>
+
+<p>If you have a desktop computer, you should be able to use controls on the monitor to change the brightness of the screen. How you do this depends very much on what monitor you have - some have specific buttons to change brightness, whereas others have buttons which you use to navigate on-screen menus.</p>
+
+<p>If you have increased the brightness to the maximum but it's still not bright enough, you may need to adjust the <em>contrast</em> or <em>gamma</em> settings of the screen instead. Not all screens allow you to change both of these settings, however.</p>
+
 </page>
diff --git a/gnome-help/C/power-closelid.page b/gnome-help/C/power-closelid.page
index 894e4f0..b23d216 100644
--- a/gnome-help/C/power-closelid.page
+++ b/gnome-help/C/power-closelid.page
@@ -6,9 +6,10 @@
   <info>
     <link type="guide" xref="power#problems"/>
     <link type="guide" xref="hardware#power"/>
+    <link type="seealso" xref="power-suspendfail"/>
     
-    <desc>XXX</desc>
-    <revision pkgversion="0.1" version="0.1" date="2010-06-29" status="stub"/>
+    <desc>Laptops go to sleep when you close the lid in order to save power.</desc>
+    <revision pkgversion="0.1" version="0.1" date="2010-06-29" status="incomplete"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -17,8 +18,18 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>Why does my computer turn off when I close the lid?</title>
-  
+<title>Why does my computer turn off when I close the lid?</title>
+
+<p>When you close the lid of your laptop, your computer will <em>suspend</em> in order to save power. This means that the computer is not actually turned off - it has just gone to sleep. You can wake it up by opening the lid. If it doesn't wake up, try clicking the mouse or pressing a key. If that still doesn't work, press the power button.</p>
+
+<p>Some computers are unable to suspend properly, normally because their hardware isn't completely supported by the operating system (e.g. the Linux drivers are incomplete). In this case, you may find that you are unable to wake-up your computer after you've closed the lid. You can try to <link xref="power-suspendfail">fix the problem with suspend</link>, or you can prevent the computer from trying to suspend when you close the lid.</p>
+
+<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...</p>
+ <!-- FIXME: Need to complete this section! -->
+</section>
+
   <comment>
    <cite date="2010-06-29" href="mailto:gnome-doc-list gnome org">GNOME Documentation Project</cite>
    <p>Explain that the computer probably hasn't turned off, it just suspended itself. Describe how to wake up from being suspended. Explain that some computers don't suspend properly. Show how you can change the settings for what happens when the lid is closed.</p>
diff --git a/gnome-help/C/power-history.page b/gnome-help/C/power-history.page.old
similarity index 86%
rename from gnome-help/C/power-history.page
rename to gnome-help/C/power-history.page.old
index 8457c34..42faa9e 100644
--- a/gnome-help/C/power-history.page
+++ b/gnome-help/C/power-history.page.old
@@ -1,12 +1,13 @@
 <page xmlns="http://projectmallard.org/1.0/";
       xmlns:e="http://projectmallard.org/experimental/";
       type="topic"
+      style="ui"
       id="power-history">
 
   <info>
     <link type="guide" xref="power#battery"/>
     <desc>XXX</desc>
-    <revision pkgversion="0.1" version="0.1" date="2010-06-29" status="stub"/>
+    <revision pkgversion="0.1" version="0.1" date="2011-03-19" status="stub"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -15,8 +16,10 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>Power statistics</title>
-  
+<title>Power statistics</title>
+
+<p></p>
+
   <comment>
    <cite date="2010-06-29" href="mailto:gnome-doc-list gnome org">GNOME Documentation Project</cite>
    <p>An explanation of the GPM Power Statistics tab. Explain what the options show, and what interesting information you can get out of it. Probably need to ask the GPM maintainer for explanation of some items.</p>
diff --git a/gnome-help/C/power-lowpower.page b/gnome-help/C/power-lowpower.page
index d65e902..9b7e5f7 100644
--- a/gnome-help/C/power-lowpower.page
+++ b/gnome-help/C/power-lowpower.page
@@ -5,8 +5,8 @@
 
   <info>
     <link type="guide" xref="power#battery"/>
-    <desc>XXX</desc>
-    <revision pkgversion="0.1" version="0.1" date="2010-06-29" status="stub"/>
+    <desc>Allowing the battery to completely discharge is bad for it.</desc>
+    <revision pkgversion="0.1" version="0.1" date="2011-03-19" status="review"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -15,8 +15,14 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>Why did my computer turn off/hibernate when the battery got to 10%?</title>
-  
+<title>Why did my computer turn off/hibernate when the battery got to 10%?</title>
+
+<p>When the charge level of the battery gets too low, your computer will automatically hibernate (that is, it will save all of your open documents and applications, and then turn off). It does this to make sure that the battery doesn't completely discharge, since this is bad for the battery. If the battery just ran out, the computer wouldn't have time to shut down properly either.</p>
+
+<p>You can change what happens when the battery level gets too low by clicking your name at the top of the screen, selecting <gui>System Settings</gui>, and then opening the <gui>Power</gui> settings. Look at the <gui>When power is critically low</gui> setting. You can choose for the computer to hibernate or shut down; if you choose shut down, your applications and documents <em>will not</em> be saved before the computer turn off.</p>
+
+<p>Some computers have problems hibernating, and may not be able to recover the applications and documents you had open when you turn on the computer again. In this case, it is possible that you could lose some of your work if you didn't save it before the computer hibernated. You may be able to <link xref="power-suspendfail">fix problems with hibernation</link> though.</p>
+
   <comment>
    <cite date="2010-06-29" href="mailto:gnome-doc-list gnome org">GNOME Documentation Project</cite>
    <p>Explain that the computer shuts down when it gets to low battery. Check that 10% is the default threshold (it might be lower). Explain how to change the threshold setting, and the power-down behaviour (i.e. shut down or hibernate).</p>



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