[gnome-boxes] help: flesh out interface page

[Michael Hill <mdhill src gnome org>]

commit 0d410d4a175adf78fe662c7c503946bc66efc951
Author: Michael Hill <mdhill gnome org>
Date:   Sun Sep 14 15:52:05 2014 -0400

    help: flesh out interface page

 help/C/index.page     |    4 ---
 help/C/interface.page |   56 +++++++++++++++++++++++++++++++++++++++++++-----
 help/C/shortcuts.page |    2 +-
 3 files changed, 51 insertions(+), 11 deletions(-)
---
diff --git a/help/C/index.page b/help/C/index.page
index 40cec47..013f4ae 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -54,17 +54,13 @@
     <title>Using Boxes</title>
   </section>
 
-<!--
   <section id="properties" style="2column">
     <title>Properties</title>
   </section>
--->
 
-<!--
   <section id="snapshots" style="2column">
     <title>Snapshots</title>
   </section>
--->
 
   <section id="faq" style="2column">
     <title>Questions</title>
diff --git a/help/C/interface.page b/help/C/interface.page
index 6768aa1..5c6293c 100644
--- a/help/C/interface.page
+++ b/help/C/interface.page
@@ -23,9 +23,19 @@
   <title>Collection view</title>
 
   <p>When you first launch <app>Boxes</app>, the greeting tells you to click the
-  <gui style="button">New</gui> button. On subsequent visits, <app>Boxes</app>
-  opens in the <em>collection view</em>, displaying thumbnails of your boxes.
-  Favourites or frequently-used boxes appear at the top of the list.</p>
+  <gui style="button">New</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. Favourites or frequently-used boxes
+  appear at the top of the list. Collection view allows you to:</p>
+
+  <list>
+    <item><p>Click <gui style="button">New</gui> to
+    <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>Click the checkmark button or select a box to enter selection
+    mode.</p></item>
+  </list>
 
   </section>
 
@@ -42,7 +52,14 @@
 
   <p>In collection view, clicking the checkmark button or right-clicking a
   thumbnail puts you in <em>selection mode</em>, where various operations can be
-  performed on boxes, individually or in groups.</p>
+  performed on boxes, individually or in groups. You can:</p>
+
+  <list>
+    <item><p><link xref="delete">Delete</link> a box or boxes.</p></item>
+    <item><p>Mark a box or boxes as favourites.</p></item>
+    <item><p>Click the <gui style="button">Properties</gui> button to enter the
+    properties view of a box.</p></item>
+  </list>
 
   </section>
 
@@ -50,8 +67,35 @@
   <title>Properties view</title>
 
   <p>Clicking the <gui style="button">Properties</gui> button in selection mode
-  opens the <em>properties view</em>, where details of a box can be
-  configured.</p>
+  opens the <em>properties view</em>, where some of the details of a box can be
+  configured. The main window displays the name of the box, the virtualizer
+  being used, and the URI that can be used to access the box from outside of
+  <app>Boxes</app>. In addition, the sidebar displays:</p>
+
+  <list>
+    <item><p>A screenshot of the box.</p></item>
+    <item><p>Running graphs of CPU, disk I/O and network activity.</p></item>
+    <item><p>The <gui style="button">Force Shutdown</gui> button, which enables
+    you to <link xref="shutdown">force a box to shut down</link>.</p></item>
+  </list>
+
+  <p>The properties view main window allows you to display or change settings
+  depending on which of the following categories is selected in the sidebar:</p>
+
+  <list>
+    <item><p><gui>System</gui> settings: memory, maximum allowed disk space,
+    and the <gui>Trouble Log</gui>.</p></item>
+    <item><p><gui>Display</gui> settings: display protocol, clipboard sharing,
+    resizing of the display.</p></item>
+    <item><p><gui>Device</gui> settings: access to system USB or CD/DVD
+    devices.</p></item>
+    <item><p><gui>Snapshots</gui>: creating and managing snaphots of the
+    box.</p></item>
+  </list>
+
+  <p>The properties view can also be accessed using the wizard's
+  <gui style="button">Customize</gui> button during box setup, and by clicking
+  the tool button in the header bar of a running session.</p>
 
   </section>
 
diff --git a/help/C/shortcuts.page b/help/C/shortcuts.page
index 91af6e6..90eba9e 100644
--- a/help/C/shortcuts.page
+++ b/help/C/shortcuts.page
@@ -15,7 +15,7 @@
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
-    <desc>Operate Boxes using keyboard shortcuts.</desc>
+    <desc>Operate <app>Boxes</app> using keyboard shortcuts.</desc>
   </info>
 
   <title>Keyboard shortcuts</title>