gnome-help: update power pages and close #88wip/mdh

9 files changed, 139 insertions, 15 deletions

diff --git a/gnome-help/C/display-brightness.page b/gnome-help/C/display-brightness.page
index 76b0fbfc..62c1b55e 100644
--- a/gnome-help/C/display-brightness.page
+++ b/gnome-help/C/display-brightness.page
@@ -9,10 +9,7 @@
     <link type="seealso" xref="power-whydim"/>
     <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"/>
-    <revision pkgversion="3.28" date="2018-07-19" status="review"/>
-    <revision pkgversion="3.33" date="2019-07-19" status="candidate"/>
+    <revision version="gnome:40" date="2021-03-21" status="candidate"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
@@ -73,8 +70,9 @@
       <p>Click <gui>Power</gui> to open the panel.</p>
     </item>
     <item>
-      <p>Adjust the <gui>Screen brightness</gui> slider to the value you want to
-      use. The change should take effect immediately.</p>
+      <p>In the <gui>Power Saving</gui> section, adjust the <gui>Screen
+      brightness</gui> slider to the value you want to use. The change should
+      take effect immediately.</p>
     </item>
   </steps>
 
diff --git a/gnome-help/C/power-autosuspend.page b/gnome-help/C/power-autosuspend.page
index 4170c84a..852f3bb2 100644
--- a/gnome-help/C/power-autosuspend.page
+++ b/gnome-help/C/power-autosuspend.page
@@ -8,8 +8,7 @@
      <link type="seealso" xref="power-suspend"/>
      <link type="seealso" xref="shell-exit#suspend"/>
 
-    <revision pkgversion="3.20" date="2016-06-15" status="candidate"/>
-    <revision pkgversion="3.33.3" date="2019-07-21" status="candidate"/>
+    <revision version="gnome:3.38.3" date="2021-03-07" status="candidate"/>
 
     <credit type="author copyright">
       <name>Michael Hill</name>
@@ -37,7 +36,7 @@
       <p>Click <gui>Power</gui> to open the panel.</p>
     </item>
     <item>
-      <p>In the <gui>Suspend &amp; Power Button</gui> section, click
+      <p>In the <gui>Power Saving</gui> section, click
       <gui>Automatic suspend</gui>.</p>
     </item>
     <item>
diff --git a/gnome-help/C/power-batteryestimate.page b/gnome-help/C/power-batteryestimate.page
index a6d53eec..e7416958 100644
--- a/gnome-help/C/power-batteryestimate.page
+++ b/gnome-help/C/power-batteryestimate.page
@@ -5,9 +5,12 @@
   <info>
 
     <link type="guide" xref="power#faq"/>
+    <link type="guide" xref="status-icons#batteryicons" />
+
     <revision pkgversion="3.4.0" date="2012-02-20" status="review"/>
     <revision pkgversion="3.18" date="2015-09-28" status="final"/>
     <revision pkgversion="3.20" date="2016-06-15" status="final"/>
+    <revision version="gnome:40" date="2021-03-22" status="candidate"/>
 
     <desc>The battery life displayed when you click on the <gui>battery icon</gui> is an estimate.</desc>
 
diff --git a/gnome-help/C/power-percentage.page b/gnome-help/C/power-percentage.page
new file mode 100644
index 00000000..6ddf29ad
--- /dev/null
+++ b/gnome-help/C/power-percentage.page
@@ -0,0 +1,50 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="topic"
+      style="task"
+      id="power-percentage">
+
+  <info>
+
+    <link type="guide" xref="power" />
+    <link type="guide" xref="status-icons" />
+    <link type="seealso" xref="power-status"/>
+
+    <revision version="gnome:40" date="2021-03-21" status="candidate"/>
+
+    <credit type="author copyright">
+      <name>Michael Hill</name>
+      <email>mdhillca@gmail.com</email>
+      <years>2021</years>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Display the battery percentage in the top bar.</desc>
+  </info>
+  
+  <title>Show the battery status as a percentage</title>
+
+  <p>The <link xref="status-icons#batteryicons">status icon</link> in the top
+    bar shows the charge level of the main internal battery, and whether it is
+    currently charging or not. In addition, the charge can be displayed as a
+    percentage.</p>
+
+  <steps>
+
+    <title>Display the battery percentage in the top bar</title>
+
+    <item>
+      <p>Open the <gui xref="shell-introduction#activities">Activities</gui>
+      overview and start typing <gui>Power</gui>.</p>
+    </item>
+    <item>
+      <p>Click <gui>Power</gui> to open the panel.</p>
+    </item>
+    <item>
+      <p>In the <gui>Suspend &amp; Power Button</gui> section, set <gui>Show
+      Battery Percentage</gui> to on.</p>
+    </item>
+
+  </steps>
+
+</page>
diff --git a/gnome-help/C/power-profile.page b/gnome-help/C/power-profile.page
new file mode 100644
index 00000000..2911b74c
--- /dev/null
+++ b/gnome-help/C/power-profile.page
@@ -0,0 +1,62 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="topic"
+      style="task"
+      id="power-profile">
+
+  <info>
+    <link type="guide" xref="power#saving"/>
+    <link type="seealso" xref="display-brightness"/>
+
+    <revision version="gnome:40" date="2021-03-21" status="candidate"/>
+
+    <credit type="author copyright">
+      <name>Michael Hill</name>
+      <email>mdhillca@gmail.com</email>
+      <years>2021</years>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Balance performance and battery usage.</desc>
+  </info>
+
+  <title>Choose a power profile</title>
+
+  <p>You can manage power usage by choosing a <gui>Power Mode</gui>. There are
+  three possible profiles:</p>
+  
+  <list>
+    <item>
+      <p><gui>Balanced Power</gui>: Standard performance and power usage. This is the
+      default setting.</p>
+    </item>
+    <item>
+      <p><gui>Power Saver</gui>: Reduced performance and power usage. This setting
+      maximizes battery life. It may enable some power saving options and
+      prevent them from being switched off.</p>
+    </item>
+    <item>
+      <p><gui>Performance</gui>: High performance and power usage. This mode will only
+      be visible if it is supported by your computer. It will be selectable if
+      your computer is running on AC power. If your device supports lap
+      detection, you will not be able to select this option if the device is
+      running on someone's lap.</p>
+    </item>
+  </list>
+
+  <steps>
+    <title>To choose a power profile:</title>
+    <item>
+      <p>Open the <gui xref="shell-introduction#activities">Activities</gui>
+      overview and start typing <gui>Power</gui>.</p>
+    </item>
+    <item>
+      <p>Click <gui>Power</gui> to open the panel.</p>
+    </item>
+    <item>
+      <p>In the <gui>Power Mode</gui> section, choose one of the profiles.</p>
+    </item>
+    
+  </steps>
+
+</page>
diff --git a/gnome-help/C/power-status.page b/gnome-help/C/power-status.page
index 9f764e3e..afdd85fb 100644
--- a/gnome-help/C/power-status.page
+++ b/gnome-help/C/power-status.page
@@ -6,9 +6,10 @@
   <info>
 
     <link type="guide" xref="power" group="#first"/>
+    <link type="guide" xref="status-icons" />
     <link type="seealso" xref="power-batterylife"/>
 
-    <revision pkgversion="3.20" date="2016-06-15" status="candidate"/>
+    <revision version="gnome:40" date="2021-03-21" status="candidate"/>
 
     <credit type="author copyright">
       <name>Michael Hill</name>
@@ -32,8 +33,8 @@
       overview and start typing <gui>Power</gui>.</p>
     </item>
     <item>
-      <p>Click <gui>Power</gui> to open the panel. The status of known devices
-      is displayed.</p>
+      <p>Click <gui>Power</gui> to open the panel. The status of
+      <gui>Batteries</gui> and known <gui>Devices</gui> is displayed.</p>
     </item>
 
   </steps>
@@ -57,5 +58,10 @@
 
     <p>The <gui>Devices</gui> section displays the status of connected
     devices.</p>
+    
+    <p>The <link xref="status-icons#batteryicons">status icon</link> in the top
+    bar shows the charge level of the main internal battery, and whether it is
+    currently charging or not. It can also display the charge as a
+    <link xref="power-percentage">percentage</link>.</p>
 
 </page>
diff --git a/gnome-help/C/power-wireless.page b/gnome-help/C/power-wireless.page
index 2eeefc08..942a0c15 100644
--- a/gnome-help/C/power-wireless.page
+++ b/gnome-help/C/power-wireless.page
@@ -9,6 +9,7 @@
 
     <revision pkgversion="3.20" date="2016-06-15" status="candidate"/>
     <revision pkgversion="3.33.3" date="2019-07-21" status="candidate"/>
+    <revision version="gnome:40" date="2021-03-21" status="candidate"/>
 
     <credit type="author copyright">
       <name>Michael Hill</name>
@@ -37,9 +38,8 @@
     </item>
     <item>
       <p>The <gui>Power Saving</gui> section contains switches for
-      <gui>Wi-Fi</gui>, <gui>Mobile broadband</gui>, and <gui>Bluetooth</gui>.
-      Switch the unused services to off. Re-enable when needed by switching to
-      on.</p>
+      <gui>Wi-Fi</gui> and <gui>Bluetooth</gui>. Switch the unused services to
+      off. Re-enable when needed by switching to on.</p>
     </item>
 
   </steps>
diff --git a/gnome-help/C/status-icons.page b/gnome-help/C/status-icons.page
index 41d28a1d..a8133263 100644
--- a/gnome-help/C/status-icons.page
+++ b/gnome-help/C/status-icons.page
@@ -218,6 +218,10 @@
     <td><p>Power icon displayed on systems without a battery.</p></td>
   </tr>
 </table>
+
+<list style="compact">
+  <item><p><link xref="power-status">Learn more about battery status.</link></p></item>
+</list>
 </section>
 
 
diff --git a/gnome-help/Makefile.am b/gnome-help/Makefile.am
index 4eccfc8f..676a8b57 100644
--- a/gnome-help/Makefile.am
+++ b/gnome-help/Makefile.am
@@ -355,6 +355,8 @@ HELP_FILES = \
 	power-lowpower.page \
 	power-nowireless.page \
 	power-othercountry.page \
+	power-percentage.page \
+	power-profile.page \
 	power-status.page \
 	power-suspendfail.page \
 	power-suspend.page \