[gnome-user-docs] Add content to more power- topics, discuss what drivers are

From: Phil Bull <philbull src gnome org>
To: commits-list gnome org
Cc:
Subject: [gnome-user-docs] Add content to more power- topics, discuss what drivers are
Date: Sat, 19 Mar 2011 21:50:18 +0000 (UTC)
commit b0d6fa8d40772a414e2e46c9c6add62638ded91e
Author: Phil Bull <philbull gmail com>
Date:   Sat Mar 19 17:50:04 2011 -0400

    Add content to more power- topics, discuss what drivers are

 gnome-help/C/hardware-driver.page        |   31 +++++++++++++++++++++++++++
 gnome-help/C/power-suspendfail.page      |   34 +++++++++++++++++++++++++----
 gnome-help/C/power-suspendhibernate.page |   25 +++++++++++++--------
 gnome-help/C/power-turnoffbutton.page    |   17 +++++++--------
 gnome-help/C/power-willnotturnon.page    |   31 +++++++++++++++++++++++---
 5 files changed, 110 insertions(+), 28 deletions(-)
---
diff --git a/gnome-help/C/hardware-driver.page b/gnome-help/C/hardware-driver.page
new file mode 100644
index 0000000..1a7ae19
--- /dev/null
+++ b/gnome-help/C/hardware-driver.page
@@ -0,0 +1,31 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="hardware-driver">
+
+  <info>
+    <link type="guide" xref="hardware"/>
+    
+    <desc>A hardware/device driver is something that allows your computer to use devices that are attached to it.</desc>
+    
+    <revision pkgversion="3.0" version="0.1" date="2011-03-19" status="review"/>
+    <credit type="author">
+      <name>GNOME Documentation Project</name>
+      <email>gnome-doc-list gnome org</email>
+    </credit>
+    
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+
+<title>What is a driver?</title>
+
+<p>There are lots of different devices that can be attached to your computer. These can include things that are attached to it externally, like printers and monitors, to things that are inside the computer itself, like graphics cards and sound cards.</p>
+
+<p>In order for your computer to be able to use these devices, it needs to know how to communicate with them. This is done by a piece of software called a <em>device driver</em>.</p>
+
+<p>When you attach a device to your computer, you must have the correct driver installed for that device to work. For example, if you plug-in a printer but the correct driver isn't available, you won't be able to use the printer. Normally, different makes and models of device have different drivers, so you can't use the driver for one device to try and get a different device to work.</p>
+
+<p>On Linux, the drivers for most devices are installed by default, so everything should just work when you plug it in. Some devices don't have drivers, however, so may not work. You might need to install the correct driver yourself, or the correct driver may not even be available!</p>
+
+<p>In addition, some drivers are incomplete or don't work properly. In this case, some of the features of your device may not work; for example, you might find that your printer can't do double-sided printing.</p>
+
+</page>
diff --git a/gnome-help/C/power-suspendfail.page b/gnome-help/C/power-suspendfail.page
index 2983ba9..2cab58d 100644
--- a/gnome-help/C/power-suspendfail.page
+++ b/gnome-help/C/power-suspendfail.page
@@ -1,5 +1,4 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      xmlns:e="http://projectmallard.org/experimental/";
       type="topic"
       id="power-suspendfail">
 
@@ -7,9 +6,9 @@
     <link type="guide" xref="power#problems"/>
     <link type="guide" xref="hardware#power"/>
     
-    <desc>XXX</desc>
+    <desc>Some computer hardware causes problems with suspend/hibernate</desc>
     
-    <revision pkgversion="0.1" version="0.1" date="2010-06-29" status="stub"/>
+    <revision pkgversion="3.0" version="0.1" date="2011-03-19" status="incomplete"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -18,8 +17,33 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>Why won't my computer turn back on after I suspended it?</title>
-  
+<title>Why won't my computer turn back on after I sent it to sleep?</title>
+
+<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>
+
+<section id="wakeup">
+ <title>My computer is asleep and won't wake up</title>
+ <p>If you sent your computer to sleep (suspended it) and then press a key or click the mouse, it should wake up and display a screen asking for your password. If this does not happen, try pressing the power button (don't hold it in; just press it once).</p>
+ <p>If this still doesn't help, make sure that your computer's monitor is switched on and try pressing a key on the keyboard again.</p>
+ <p>As a last resort, turn off the computer by holding-in the power button for 5-10 seconds. You will lose any unsaved work by doing this. You should then be able to turn on the computer again, though.</p>
+ <p>If this happens every time you send your computer to sleep, the suspend feature may not work with your hardware.</p>
+</section>
+
+<section id="hibernate">
+ <title>None of my applications/documents are open when I turn on the computer again</title>
+ <p>If you hibernated your computer and switched it on again, but none of your documents or applications are open, it probably failed to hibernate properly. Sometimes this happens because of a minor problem, and the computer will be able to hibernate properly the next time you do it. It might also happen because you had installed a software update which required the computer to be restarted; in this case, the computer may have shut down instead of hibernating.</p>
+ 
+ <p>It is also possible that the computer is not capable of hibernating because the hardware doesn't support it properly. This might be because of a problem with Linux drivers for your hardware, for example. You can test this by hibernating again and seeing if it works the second time. If it doesn't, it's probably a problem with your computer's drivers.</p>
+
+</section>
+
+<section id="hardware">
+ <title>My wireless connection (or other hardware) doesn't work when I wake up my computer</title>
+ <p>If you send your computer to sleep or hibernate it and then wake it up again, you may find that your internet connection, mouse, or some other device doesn't work properly. This could be because the device's driver doesn't properly support suspend/hibernate. This is a <link xref="hardware-driver">problem with the driver</link> and not the device itself.</p>
+ <p>If the device has a power switch, try turning it off and then on again. In most cases, the device will start working again. If it connects via a USB cable or similar, unplug the device and then plug it in again and see if it works.</p>
+ <p>If you cannot turn off/unplug the device, or if this doesn't work, you may need to restart your computer for the device to start working again.</p>
+</section>
+
   <comment>
    <cite date="2010-06-29" href="mailto:gnome-doc-list gnome org">GNOME Documentation Project</cite>
    <p>Explain symptoms of computer that failed to resume from a suspend problerly. Give troubleshooting steps.</p>
diff --git a/gnome-help/C/power-suspendhibernate.page b/gnome-help/C/power-suspendhibernate.page
index ed86da6..0c35ce8 100644
--- a/gnome-help/C/power-suspendhibernate.page
+++ b/gnome-help/C/power-suspendhibernate.page
@@ -1,5 +1,4 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      xmlns:e="http://projectmallard.org/experimental/";
       type="topic"
       id="power-suspendhibernate">
 
@@ -7,9 +6,9 @@
     <link type="guide" xref="power#problems"/>
     <link type="guide" xref="hardware#power"/>
     
-    <desc>XXX</desc>
+    <desc>Suspend sends it to sleep; hibernate saves your files but completely switches off the power.</desc>
     
-    <revision pkgversion="0.1" version="0.1" date="2010-06-29" status="stub"/>
+    <revision pkgversion="3.0" version="0.1" date="2011-03-19" status="review"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -18,11 +17,17 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>What happens when I suspend/hibernate the computer?</title>
-  
-  <comment>
-   <cite date="2010-06-29" href="mailto:gnome-doc-list gnome org">GNOME Documentation Project</cite>
-   <p>Explain what happens when you choose to suspend or hibernate the computer. Explain whether apps will remain open or not, whether power will be used or not. Explain how to resume. Warn user that they should save all work in case of any problems.</p>
-  </comment>
-	
+<title>What happens when I suspend/hibernate the computer?</title>
+
+<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>
+
+<p>When you <em>hibernate</em> the computer, all of your applications and documents remain open (actually, they are saved to disk) and the computer completely switches off, so it doesn't use any power. It is like shutting down, but your applications and documents will still be open when you switch on the computer again.</p>
+
+<p>Some computers have problems with hardware support which mean that they <link xref="power-suspendfail">may not be able to suspend or hibernate properly</link>. It is a good idea to test suspend/hibernate on your computer to see if it does work.</p>
+
+<note style="important">
+ <title>Always save your work before suspending/hibernating</title>
+ <p>You should save all of your work before suspending or hibernating the computer, just in case something goes wrong and your open applications and documents can't be recovered when you switch on the computer again.</p>
+</note>
+
 </page>
diff --git a/gnome-help/C/power-turnoffbutton.page b/gnome-help/C/power-turnoffbutton.page
index bda2f7e..412fa2b 100644
--- a/gnome-help/C/power-turnoffbutton.page
+++ b/gnome-help/C/power-turnoffbutton.page
@@ -5,8 +5,8 @@
 
   <info>
     <link type="guide" xref="power#preferences"/>
-    <desc>XXX</desc>
-    <revision pkgversion="0.1" version="0.1" date="2010-06-29" status="stub"/>
+    <desc>Look in <guiseq><gui>System Settings</gui><gui>Power</gui></guiseq> for the option to change this.</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 +15,10 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>I want the computer to turn off when I press the power button</title>
-  
-  <comment>
-   <cite date="2010-06-29" href="mailto:gnome-doc-list gnome org">GNOME Documentation Project</cite>
-   <p>By default, the user is asked what to do when the physical power button of the computer is pressed. You can make the computer turn off immediately rather than prompting.</p>
-  </comment>
-	
+<title>I want the computer to turn off when I press the power button</title>
+
+<p>When you press the power button on your computer, a window will pop up asking what you want to do - whether you want to turn off the computer, send it to sleep and so on. You can make it so that one of these options happens automatically when you press the power button, rather than showing this window.</p>
+
+<p>Click your name at the top of the screen, select <gui>System Settings</gui> and double-click <gui>Power</gui>. Change the option labeled <gui>When the power button is pressed</gui>. For example, if you choose <gui>Suspend</gui>, the computer will go to sleep when you press the power button. The default option is <gui>Ask me</gui>.</p>
+
 </page>
diff --git a/gnome-help/C/power-willnotturnon.page b/gnome-help/C/power-willnotturnon.page
index 963ff93..42dd1f3 100644
--- a/gnome-help/C/power-willnotturnon.page
+++ b/gnome-help/C/power-willnotturnon.page
@@ -5,8 +5,8 @@
 
   <info>
     <link type="guide" xref="power#problems"/>
-    <desc>XXX</desc>
-    <revision pkgversion="0.1" version="0.1" date="2010-06-29" status="stub"/>
+    <desc>Loose cables and hardware problems are possible reasons.</desc>
+    <revision pkgversion="3.0" version="0.1" date="2011-03-19" status="incomplete"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -15,8 +15,31 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>My computer will not turn on</title>
-  
+<title>My computer will not turn on</title>
+
+<p>There are a number of reasons why your computer will not turn on. This topic gives a brief overview of some of the possible reasons.</p>
+
+<section id="nopower">
+ <title>Computer not plugged in, empty battery, or loose cable</title>
+ <p>Make sure that the power cables of the computer are firmly plugged in and the power outlets are switched on. Make sure that the monitor is plugged in and switched on too. If you have a laptop, connect the charging cable (in case it has run out of battery). You may also want to check that the battery is correctly fitted in place (check the underside of the laptop).</p>
+</section>
+ 
+<section id="hardwareproblem">
+ <title>Problem with the computer hardware</title>
+ <p>A component of your computer may be broken or malfunctioning. If this is the case, you will need to get your computer repaired. Common faults include a broken power supply unit, incorrectly-fitted components (such as the memory/RAM) and a faulty motherboard.</p>
+</section>
+ 
+<section id="beeps">
+ <title>The computer beeps and then switches off</title>
+ <p>If the computer beeps several times when you turn it on and then turns off (or fails to start), it may be indicating that it has detected a problem. These beeps are sometimes referred to as <em>beep codes</em>, and the pattern of beeps is intended to tell you what the problem with the computer is. Different manufacturers use different beep codes, so you will have to consult the manual for your computer's motherboard, or take your computer in for repairs.</p>
+</section>
+
+<section id="fans">
+ <title>The computer fans are spinning but nothing is on the screen</title>
+ <p>The first thing to check is that your monitor is plugged in and turned on.</p>
+ <p>This problem could also be due to a hardware fault. The fans might turn on when you press the power button, but other essential parts of the computer might fail to turn on. In this case, take your computer in for repairs.</p>
+</section>
+
   <comment>
    <cite date="2010-06-29" href="mailto:gnome-doc-list gnome org">GNOME Documentation Project</cite>
    <p>This is a complicated topic. Give troubleshooting steps/reasons for why the computer won't turn on. SOme of the reasons may be down to hardware failure.</p>
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]