[gnome-boxes/update-docs: 63/73] docs, help: Update information about the Preferences interface




commit bd619ffc5c965860c82f41effd4ad75921f9eb2b
Author: Felipe Borges <felipeborges gnome org>
Date:   Wed Jan 5 11:47:47 2022 +0100

    docs, help: Update information about the Preferences interface
    
    This UI has changed drastically since the last version.

 help/C/3d-acceleration.page |  2 +-
 help/C/edit-domain.page     |  2 +-
 help/C/index.page           |  4 +--
 help/C/interface.page       | 69 ++++++++++++++++++++++++---------------------
 help/C/prop-system.page     |  2 +-
 help/C/prop-trouble.page    |  2 +-
 help/C/shutdown.page        |  2 +-
 7 files changed, 44 insertions(+), 39 deletions(-)
---
diff --git a/help/C/3d-acceleration.page b/help/C/3d-acceleration.page
index ca6466e5..a715c4f0 100644
--- a/help/C/3d-acceleration.page
+++ b/help/C/3d-acceleration.page
@@ -37,7 +37,7 @@
     <gui>Properties</gui>, or click the menu
     (<media type="image" src="figures/view-more-symbolic.svg" its:translate="no"><span 
its:translate="yes">settings</span></media>)
     button in the header bar and select <gui>Properties</gui>.</p></item>
-    <item><p>The <link xref="interface#properties">Properties view</link>
+    <item><p>The <link xref="interface#preferences">Properties view</link>
     opens, with the General tab selected by default.</p></item>
     <item><p>If 3D Acceleration is supported, the <gui>3D Acceleration</gui> switch would 
     appear here. By default, it is disabled. To enable 3D Acceleration, simply toggle the 
diff --git a/help/C/edit-domain.page b/help/C/edit-domain.page
index dde35132..6714ef68 100644
--- a/help/C/edit-domain.page
+++ b/help/C/edit-domain.page
@@ -4,7 +4,7 @@
       id="edit-domain">
   <info>
     <revision pkgversion="40.rc" date="2021-03-10" status="review"/>
-    <link type="guide" xref="index#properties"/>
+    <link type="guide" xref="index#preferences"/>
 
     <credit type="author copyright">
       <name>Felipe Borges</name>
diff --git a/help/C/index.page b/help/C/index.page
index ae41b091..29ebcbc7 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -52,8 +52,8 @@
     <title>Using Boxes</title>
   </section>
 
-  <section id="properties" style="2column">
-    <title>Properties</title>
+  <section id="preferences" style="2column">
+    <title>Preferences</title>
   </section>
 
   <section id="snapshots" style="2column">
diff --git a/help/C/interface.page b/help/C/interface.page
index 5500d3bc..0c163d2d 100644
--- a/help/C/interface.page
+++ b/help/C/interface.page
@@ -38,7 +38,7 @@
   <p>When you first launch <app>Boxes</app>, the greeting tells you to click the
   <gui style="button">+</gui> button to create your first box. On subsequent
   visits, <app>Boxes</app> opens in the <em>collection view</em>, displaying
-  thumbnails of your boxes in a grid. Frequently-used boxes
+  thumbnails of your boxes in a grid. Frequently used boxes
   appear at the top of the list. Collection view allows you to:</p>
 
   <list>
@@ -46,9 +46,9 @@
     <link xref="create">create</link> a box.</p></item>
     <item><p>Click a box to launch a virtual machine session.</p></item>
     <item><p><link xref="search">Search</link> for a box.</p></item>
-    <item><p>Right click on a box to choose <gui>Open in New Window</gui>,
+    <item><p>Right-click on a box to choose <gui>Open in New Window</gui>,
     <gui>Force Shutdown</gui>,
-    <gui>Clone</gui>, <gui>Delete</gui>, or to open the <gui>Properties</gui>
+    <gui>Clone</gui>, <gui>Delete</gui>, or to open the <gui>Preferences</gui>
     view for the box.</p></item>
   </list>
 
@@ -62,40 +62,45 @@
 
   </section>
 
-  <section id="properties">
-  <title>Properties view</title>
+  <section id="preferences">
+  <title>Preferences view</title>
 
-  <p>Right clicking a box and selecting <gui style="button">Properties</gui>
-  in the collection view opens the <em>properties view</em>, where some of the
-  details of a box can be configured. The properties view allows you to display
+  <p>Right-click a box in the collection view and select
+  <gui style="button">Preferences</gui> to open the <em>preferences view</em>,
+  where you can configure some of the details of your box.
+  The preferences view allows you to display
   or change settings depending on which of the following tabs is selected:</p>
 
-  <list>
-    <item><p><gui>General</gui>: displays the box <gui>Name</gui> and
-    <gui>Broker</gui> or virtualizer being used (such as <em>QEMU</em>).
-    The <gui>3D Acceleration</gui> switch also appears here.</p></item>
-    <item><p><gui>System</gui> settings: shows running graphs of CPU, disk I/O
-    and network activity. <gui>Memory</gui> and <gui>Maximum Disk Size</gui>
-    sliders can be adjusted, and the <gui>Troubleshooting Log</gui> can be
-    viewed. The <gui style="button">Force Shutdown</gui> button, which enables
-    you to <link xref="shutdown">force a box to shut down</link>, the
-    <gui style="button">Restart</gui> button, and the
-    <gui>Run in background</gui> switch are on this tab.</p></item>
-    <item><p><gui>Devices &amp; Shares</gui>: the <gui style="button">Select</gui> button
-    allows you to specify the path to a CD/DVD device or ISO. The
-    <gui style="button">Remove</gui> button disconnects it. When the box is
-    running, the USB devices connected to the host system are listed, and each
-    can be controlled with an <gui>ON | OFF</gui> switch.
-    <link xref="shared-folders">Shared Folders</link> between host and guest
-    can be set for running machines which support spice-webdavd.</p></item>
-    <item><p><gui>Snapshots</gui>: allows you to
-    <link xref="snapshot-create">create</link> and manage snapshots of the
-    box.</p></item>
-  </list>
+  <section id="resources">
+  <title>The Resources tab</title>
+
+    <list>
+      <item><p>View the <gui>Name</gui> of your box and its <gui>IP Address</gui> (when 
available).</p></item>
+      <item><p>Set the values for <gui>CPU</gui>, <gui>Memory</gui> and <gui>Storage</gui> of your 
box.</p></item>
+      <item><p>Set the <gui>Allow running in background</gui> preference of your box.</p></item>
+      <item><p>Enable <gui>3D acceleration</gui> for supported operating systems.</p></item>
+      <item><p>Access the logs of your box in the <gui>Troubleshooting logs</gui> option, which can be 
useful for troubleshooting issues.</p></item>
+      <item><p>The <gui>Edit Configuration</gui> option lets you edit the libvirt domain configuration of 
your box manually.</p></item>
+    </list>
+  </section>
 
-  <p>If the box is running, click the menu (<media its:translate="no" type="image" 
src="figures/view-more-symbolic.svg"><span its:translate="yes">settings</span></media>)
-  button in the header bar and select <gui>Properties</gui>.</p>
+  <section id="devices-and-shares">
+  <title>The Devices and Shares tab</title>
 
+    <list>
+      <item><p>Choose the <gui>USB Devices</gui> to redirect to your box.</p></item>
+      <item><p>Set the <gui>Shared Folders</gui> to be made available in your box.</p></item>
+      <item><p>Set a <gui>CDROM/DVD Drive</gui> file or device to make available in your box.</p></item>
+    </list>
+  </section>
+
+  <section id="snapshots">
+  <title>The Snaspshots tab</title>
+    <p>With <gui>Snapshots</gui> you can <link xref="snapshot-create">create</link> and manage snapshots of 
your box.</p>
+  </section>
+
+  <p>If the box is running, click the menu (<media its:translate="no" type="image" 
src="figures/view-more-symbolic.svg"><span its:translate="yes">settings</span></media>)
+  button in the header bar and select <gui>Preferences</gui>.</p>
   </section>
 
 </page>
diff --git a/help/C/prop-system.page b/help/C/prop-system.page
index 2e5d5f3c..79a91f51 100644
--- a/help/C/prop-system.page
+++ b/help/C/prop-system.page
@@ -5,7 +5,7 @@
   <info>
     <revision pkgversion="3.14" date="2014-09-14" status="review"/>
     <revision pkgversion="3.24.0" date="2017-05-02" status="review"/>
-    <link type="guide" xref="index#properties" group="#first" />
+    <link type="guide" xref="index#preferences" group="#first" />
 
     <credit type="author copyright">
       <name>Michael Hill</name>
diff --git a/help/C/prop-trouble.page b/help/C/prop-trouble.page
index ffdedff3..85b8fe42 100644
--- a/help/C/prop-trouble.page
+++ b/help/C/prop-trouble.page
@@ -5,7 +5,7 @@
   <info>
     <revision pkgversion="3.14" date="2014-09-14" status="review"/>
     <revision pkgversion="3.24.0" date="2017-05-02" status="review"/>
-    <link type="guide" xref="index#properties"/>
+    <link type="guide" xref="index#preferences"/>
 
     <credit type="author copyright">
       <name>Michael Hill</name>
diff --git a/help/C/shutdown.page b/help/C/shutdown.page
index f68c4d55..748d1ada 100644
--- a/help/C/shutdown.page
+++ b/help/C/shutdown.page
@@ -25,7 +25,7 @@
   state.</p>
 
   <steps>
-    <item><p>Open the <link xref="interface#properties">properties view</link>
+    <item><p>Open the <link xref="interface#preferences">preferences view</link>
     for the box. If the box is running, click the menu
     (<media its:translate="no" type="image" src="figures/view-more-symbolic.svg"><span 
its:translate="yes">settings</span></media>)
     button in the header bar and select <gui>Properties</gui>.</p></item>


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