[gnome-user-docs] Update display-brightness

[Petr Kovář <pmkovar src gnome org>]

commit 363dff4d97910e660f9653f0aeea69ff3310e85d
Author: Petr Kovar <pkovar redhat com>
Date:   Wed Sep 30 17:11:14 2015 -0400

    Update display-brightness

 gnome-help/C/display-brightness.page |   64 ++++++++++++++--------------------
 gnome-help/C/power-batterylife.page  |   25 ++++++-------
 gnome-help/C/power-whydim.page       |    2 +-
 3 files changed, 39 insertions(+), 52 deletions(-)
---
diff --git a/gnome-help/C/display-brightness.page b/gnome-help/C/display-brightness.page
index 4d227fe..4fe262d 100644
--- a/gnome-help/C/display-brightness.page
+++ b/gnome-help/C/display-brightness.page
@@ -1,17 +1,17 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic"
       style="task"
-      id="display-dimscreen">
+      id="display-brightness">
 
   <info>
     <link type="guide" xref="prefs-display"/>
-    <link type="guide" xref="power#problems"/>
     <link type="guide" xref="hardware-problems-graphics"/>
     <link type="seealso" xref="power-whydim"/>
     <link type="seealso" xref="display-lock"/>
     <link type="seealso" xref="a11y-contrast"/>
 
     <revision pkgversion="3.8" version="0.4" date="2013-03-28" status="candidate"/>
+    <revision pkgversion="3.18" date="2015-09-30" status="candidate"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
@@ -40,30 +40,19 @@
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
-    <desc>Dim the screen to save power or increase the brightness to make it more readable in bright 
light.</desc>
+    <desc>Change the screen brightness to make it more readable in bright
+    light.</desc>
   </info>
 
   <title>Set screen brightness</title>
 
-  <p>You can change the brightness of your screen to save power or to make the
-  screen more readable in bright light. <!--You can also have the screen dim
-  automatically when on battery power and have it turn off automatically when
-  not in use.--></p>
+  <p>Depending on your hardware, you can change the brightness of your screen to
+  save power or to make the screen more readable in bright light.</p>
 
-  <steps>
-    <title>Set the brightness</title>
-    <item>
-      <p>Open the <app>Settings</app> from the <gui>Activities</gui>
-      overview.</p>
-    </item>
-    <item>
-      <p>Open <gui style="tab">Power</gui> settings.</p>
-    </item>
-    <item>
-      <p>Adjust the <gui>Screen brightness</gui> slider to the value that
-      you want to use. The change should take effect immediately.</p>
-    </item>
-  </steps>
+  <p>To change the brightness of your screen, click the
+  <gui xref="shell-terminology">system menu</gui> on the right side of the top
+  bar and adjust the screen brightness slider to the value you want to use. The
+  change should take effect immediately.</p>
 
   <note style="tip">
     <p>Many laptop keyboards have special keys to adjust the brightness. These
@@ -71,32 +60,31 @@
     key to use these keys.</p>
   </note>
 
-<!--  <p>Select <gui>Dim screen to save power</gui> to have the brightness
-  automatically lowered when you are on battery power. The backlight of your
-  screen can take a lot of power and significantly reduce how long your battery
-  will last before it needs to be recharged.</p>-->
-
-  <p>To save power, you can set your screen to dim automatically if you have
-  not used your computer for a while.</p>
+  <p>You can also adjust the screen brightness by using the <gui>Power</gui> panel.</p>
 
   <steps>
-    <title>Dim screen automatically when inactive</title>
+    <title>To set the screen brightness using the Power panel:</title>
     <item>
-      <p>Open the <app>Settings</app> from the <gui>Activities</gui>
-      overview.</p>
+      <p>Open the <gui xref="shell-terminology">Activities</gui> overview and
+      start typing <gui>Power</gui>.</p>
     </item>
     <item>
-      <p>Open <gui style="tab">Power</gui> settings.</p>
+      <p>Click <gui>Power</gui> to open the panel.</p>
     </item>
     <item>
-      <p>Toggle <gui>Dim screen when inactive</gui> to the <gui>On</gui>
-      position.</p>
+      <p>Adjust the <gui>Screen brightness</gui> slider to the value you want to
+      use. The change should take effect immediately.</p>
     </item>
   </steps>
 
-  <p>The screen will automatically turn off after you have not used it for a
-  while. This only affects the display, and does not turn off your computer.
-  You can adjust how long you have to be inactive in the <gui>Blank
-  screen</gui> drop down list.</p>
+  <note style="tip">
+    <p>If your computer features an integrated light sensor, the screen
+    brightness will automatically be adjusted for you. You can disable automatic
+    screen brightness in the <gui>Power</gui> panel.</p>
+  </note>
+
+  <p>If it is possible to set the brightness of your screen, you can also have
+  the screen dim automatically to save power. For more information, see
+  <link xref="power-whydim"/>.</p>
 
 </page>
diff --git a/gnome-help/C/power-batterylife.page b/gnome-help/C/power-batterylife.page
index f5c8a5e..87fa0ff 100644
--- a/gnome-help/C/power-batterylife.page
+++ b/gnome-help/C/power-batterylife.page
@@ -8,6 +8,8 @@
     <link type="seealso" xref="power-suspend"/>
     <link type="seealso" xref="shell-exit#suspend"/>
     <link type="seealso" xref="shell-exit#shutdown"/>
+    <link type="seealso" xref="display-brightness"/>
+    <link type="seealso" xref="power-whydim"/>
 
     <revision pkgversion="3.7.1" version="0.2" date="2012-11-16" status="outdated"/>
     <revision pkgversion="3.10" date="2013-11-07" status="review"/>
@@ -56,15 +58,13 @@
     case.</p>
   </item>
   <item>
-    <p>Use the <gui>Power</gui> panel in <app>Settings</app> to change
-    your power settings. There are a number of options that will help to save
-    power: you can <!--TODO: display-dimscreen is a stub. Please add the link back
-    when it's unstubbed.-Aruna<link xref="display-dimscreen">-->automatically
-    dim the display after a certain time, <!--display-dimscreen is a stub.
-    Please add the link back when it's unstubbed.-Aruna
-    <link xref="display-dimscreen">-->reduce the display brightness, and have
-    the computer <link xref="power-suspend">automatically suspend</link> if you
-    have not used it for a certain period of time.</p>
+    <p>Use the <gui>Power</gui> panel in <app>Settings</app> to change your
+    power settings. There are a number of options that will help to save power:
+    you can <link xref="power-whydim">automatically dim the screen</link> after
+    a certain time, reduce the <link xref="display-brightness">screen
+    brightness</link>, and have the computer
+    <link xref="power-suspend">automatically suspend</link> if you have not used
+    it for a certain period of time.</p>
   </item>
   <item>
     <p>Turn off any external devices (like printers and scanners) when you are
@@ -79,10 +79,9 @@
 
  <list>
    <item>
-     <p><!--display-dimscreen is a stub. Please add the link back when it's
-     unstubbed.-Aruna<link xref="display-dimscreen">-->Reduce the screen
-     brightness. Powering the screen accounts for a significant fraction of a
-     laptop power consumption.</p>
+     <p>Reduce the <link xref="display-brightness">screen
+     brightness</link>. Powering the screen accounts for a significant fraction
+     of a laptop power consumption.</p>
      <p>Most laptops have buttons on the keyboard (or a keyboard shortcut) that
      you can use to reduce the brightness.</p>
    </item>
diff --git a/gnome-help/C/power-whydim.page b/gnome-help/C/power-whydim.page
index b063552..3f3c0af 100644
--- a/gnome-help/C/power-whydim.page
+++ b/gnome-help/C/power-whydim.page
@@ -49,7 +49,7 @@
       start typing <gui>Power</gui>.</p>
     </item>
     <item>
-      <p>Click on <gui>Power</gui> to open the panel.</p>
+      <p>Click <gui>Power</gui> to open the panel.</p>
     </item>
     <item>
       <p>Switch <gui>Blank screen</gui> to <gui>OFF</gui> in the <gui>Power