[gnome-boxes: 1/3] Help: sync with 3.24 GUI
- From: Michael Hill <mdhill src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gnome-boxes: 1/3] Help: sync with 3.24 GUI
- Date: Wed, 3 May 2017 12:47:37 +0000 (UTC)
commit 8eb697a7e797e1ce20636e0a9d8e5402cb877c89
Author: Michael Hill <mdhillca gmail com>
Date: Tue May 2 19:33:44 2017 -0400
Help: sync with 3.24 GUI
https://bugzilla.gnome.org/show_bug.cgi?id=770255
help/C/clipboard.page | 15 ++++---
help/C/connect.page | 10 ++---
help/C/continuous.page | 4 +-
help/C/create.page | 13 +++---
help/C/figures/input-keyboard-symbolic.svg | 35 +++++++++++++++
help/C/figures/open-menu-symbolic.svg | 33 ++++++++++++++
help/C/interface.page | 63 +++++++++++++++------------
help/C/keystrokes.page | 53 +++++++++++++++++++++++
help/C/prop-system.page | 15 ++++---
help/C/prop-trouble.page | 19 ++++----
help/C/shutdown.page | 14 +++---
help/C/snapshot-create.page | 13 +++---
help/C/snapshot-delete.page | 16 ++++----
help/C/snapshot-rename.page | 20 +++++----
help/C/snapshot-revert.page | 18 ++++----
help/C/usb-redirection.page | 16 ++++---
help/Makefile.am | 5 ++-
17 files changed, 250 insertions(+), 112 deletions(-)
---
diff --git a/help/C/clipboard.page b/help/C/clipboard.page
index 980f53d..a1c5322 100644
--- a/help/C/clipboard.page
+++ b/help/C/clipboard.page
@@ -1,8 +1,10 @@
<page xmlns="http://projectmallard.org/1.0/";
+ xmlns:its="http://www.w3.org/2005/11/its";
type="topic" style="task"
id="clipboard">
<info>
<revision pkgversion="3.14" date="2014-09-13" status="review"/>
+ <revision pkgversion="3.24.0" date="2017-05-02" status="review"/>
<link type="guide" xref="index#use"/>
<credit type="author copyright">
@@ -22,13 +24,12 @@
<app>Boxes</app>.</p>
<steps>
- <item><p>Open the <link xref="interface#properties">properties view</link>
- for the box. If the box is open, click the
- <gui style="button">Properties</gui> button in the header bar. The
- properties view can also be accessed from
- <link xref="interface#selection">selection mode</link>.</p></item>
- <item><p>Click <gui>Display</gui> in the sidebar.</p></item>
- <item><p>Switch <gui>Share clipboard</gui> to <gui>ON</gui>.</p></item>
+ <item><p>Right-click on the box in the collection view and select
+ <gui>Properties</gui>, or if the box is running, click the menu
+ (<media its:translate="no" type="image" src="figures/open-menu-symbolic.svg"><span
its:translate="yes">settings</span></media>)
+ button in the header bar and select <gui>Properties</gui>.</p></item>
+ <item><p>On the <gui>General</gui> tab, switch <gui>Share clipboard</gui>
+ to <gui>ON</gui>.</p></item>
</steps>
<note style="important">
diff --git a/help/C/connect.page b/help/C/connect.page
index 4e053d8..7e8f9c5 100644
--- a/help/C/connect.page
+++ b/help/C/connect.page
@@ -3,6 +3,7 @@
id="connect">
<info>
<revision pkgversion="3.8.0" version="0.1" date="2013-03-23" status="candidate"/>
+ <revision pkgversion="3.24.0" date="2017-05-02" status="review"/>
<link type="guide" xref="index#start"/>
<credit type="author copyright">
@@ -22,20 +23,19 @@
<p><app>Boxes</app> can be used to view and access a remote physical or virtual machine.</p>
<note style="important">
- <p>The remote machine should already be configured.</p>
+ <p>The remote machine should already be configured, and needs to be running
+ the <em>X Windows</em> display protocol.</p>
</note>
<steps>
<item><p>Click <gui style="button">New</gui> in the top left corner to launch
the box creation wizard.</p></item>
- <item><p>An introductory message is displayed. Click
- <gui style="button">Continue</gui>.</p></item>
<item><p>At the wizard's <gui>Source Selection</gui> screen, click
<gui style="button">Enter URL</gui>.</p></item>
<item><p>Enter a URL containing the protocol, IP address and port number of
the remote device or service. For example:</p>
- <code>spice://192.168.122.1?port=5906;</code>
+ <code>vnc://192.168.122.1:5900;</code>
<p>The protocol will be:</p>
<list>
<item><p>spice:// to connect to a local or remote <app>Xspice</app>
@@ -54,8 +54,6 @@
</item>
<item><p>Click <gui style="button">Continue</gui> in the top right
corner.</p></item>
- <item><p>Click <gui style="button">Customize</gui> if you wish to rename the
- box.</p></item>
<item><p>Click <gui style="button">Create</gui>.</p></item>
</steps>
diff --git a/help/C/continuous.page b/help/C/continuous.page
index 8e12fd4..ea9bbba 100644
--- a/help/C/continuous.page
+++ b/help/C/continuous.page
@@ -1,9 +1,11 @@
<page xmlns="http://projectmallard.org/1.0/";
+ xmlns:its="http://www.w3.org/2005/11/its";
type="topic" style="task"
id="continuous">
<info>
<link type="guide" xref="index#advanced"/>
<revision pkgversion="3.14" date="2014-09-06" status="review"/>
+ <revision pkgversion="3.24.0" date="2017-05-02" status="review"/>
<credit type="author copyright">
<name>Michael Hill</name>
@@ -32,8 +34,6 @@
</item>
<item><p>In <app>Boxes</app>, click <gui style="button">New</gui> to launch
the box creation wizard.</p></item>
- <item><p>An introductory message is displayed. Click
- <gui style="button">Continue</gui>.</p></item>
<item><p>Click <gui style="button">Enter URL</gui> and type the URL
including the full filename of the gzipped runtime or devel-debug qcow2
image. Boxes will download and install the image.</p>
diff --git a/help/C/create.page b/help/C/create.page
index c6a62b5..d8732fd 100644
--- a/help/C/create.page
+++ b/help/C/create.page
@@ -4,6 +4,7 @@
<info>
<revision pkgversion="3.8.0" date="2013-03-17" status="candidate"/>
<revision pkgversion="3.14.0" date="2014-09-06" status="review"/>
+ <revision pkgversion="3.24.0" date="2017-05-02" status="review"/>
<link type="guide" xref="index#start"/>
<credit type="author copyright">
@@ -20,14 +21,12 @@
<title>Create a box</title>
<p>When <app>Boxes</app> is launched, the collection view opens, displaying
- your existing boxes. If you haven't yet created a box, the greeting reads
- <gui>No boxes found.</gui></p>
+ your existing boxes. If you haven't yet created a box, an introductory
+ message is displayed.</p>
<steps>
<item><p>Click <gui style="button">New</gui> in the top left corner to launch
the box creation wizard.</p></item>
- <item><p>An introductory message is displayed. Click
- <gui style="button">Continue</gui>.</p></item>
<item><p>At the wizard's <gui>Source Selection</gui> screen, choose a source
to determine the type of box you want to create. A local virtual machine
can be created from:</p>
@@ -36,7 +35,7 @@
<item><p>An ISO found by <app>Boxes</app>.</p></item>
<item><p>Installation media on a CD/DVD/USB drive.</p></item>
<item><p>A local ISO file (if not found automatically above).</p></item>
- <item><p>A URL to a remote machine (physical or virtual) through a
+ <item><p>A URL to a remote machine running <em>X Windows</em> using a
<link xref="connect">remote connection</link>.</p></item>
</list>
@@ -49,8 +48,8 @@
<item><p>After making your selection, or providing the necessary
information, click <gui style="button">Continue</gui>, which will take you to
the <gui>Review</gui> page.</p></item>
- <item><p>Click <gui style="button">Customize</gui> to adjust memory or
- disk size, or to rename the box.</p></item>
+ <item><p>If the box is local, click <gui style="button">Customize</gui> to
+ adjust memory or disk size, or to rename the box.</p></item>
<item><p>Click <gui style="button">Create</gui>.</p></item>
</steps>
diff --git a/help/C/figures/input-keyboard-symbolic.svg b/help/C/figures/input-keyboard-symbolic.svg
new file mode 100644
index 0000000..6d61254
--- /dev/null
+++ b/help/C/figures/input-keyboard-symbolic.svg
@@ -0,0 +1,35 @@
+<?xml version='1.0' encoding='UTF-8' standalone='no'?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg xmlns:cc='http://creativecommons.org/ns#' xmlns:dc='http://purl.org/dc/elements/1.1/'
sodipodi:docname='input-keyboard-symbolic.svg'
inkscape:export-filename='/home/sam/dev/RESOURCES/gnome-icon-theme-symbolic/src/gnome-stencils.png'
inkscape:export-xdpi='90' inkscape:export-ydpi='90' height='16' id='svg7384'
xmlns:inkscape='http://www.inkscape.org/namespaces/inkscape'
xmlns:osb='http://www.openswatchbook.org/uri/2009/osb'
xmlns:rdf='http://www.w3.org/1999/02/22-rdf-syntax-ns#'
xmlns:sodipodi='http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd' xmlns:svg='http://www.w3.org/2000/svg'
version='1.1' inkscape:version='0.92pre3 r' viewBox='0 0 16.0002 16' width='16.0002'
xmlns='http://www.w3.org/2000/svg'>
+ <metadata id='metadata90'>
+ <rdf:RDF>
+ <cc:Work rdf:about=''>
+ <dc:format>image/svg+xml</dc:format>
+ <dc:type rdf:resource='http://purl.org/dc/dcmitype/StillImage'/>
+ <dc:title>Gnome Symbolic Icon Theme</dc:title>
+ </cc:Work>
+ </rdf:RDF>
+ </metadata>
+ <sodipodi:namedview inkscape:bbox-nodes='true' inkscape:bbox-paths='true' bordercolor='#666666'
borderopacity='1' inkscape:current-layer='layer10' inkscape:cx='16.40475' inkscape:cy='2.14352'
inkscape:document-units='px' gridtolerance='10' inkscape:guide-bbox='true' guidetolerance='10'
id='namedview88' inkscape:measure-end='0,0' inkscape:measure-start='0,0' inkscape:object-nodes='true'
inkscape:object-paths='false' objecttolerance='10' pagecolor='#3a3b39' inkscape:pageopacity='1'
inkscape:pageshadow='2' showborder='false' showgrid='false' showguides='true' inkscape:snap-bbox='true'
inkscape:snap-bbox-midpoints='false' inkscape:snap-global='true' inkscape:snap-grids='true'
inkscape:snap-nodes='true' inkscape:snap-others='false' inkscape:snap-to-guides='true'
inkscape:window-height='1016' inkscape:window-maximized='1' inkscape:window-width='1920'
inkscape:window-x='0' inkscape:window-y='27' inkscape:zoom='1'>
+ <inkscape:grid dotted='false' empspacing='2' enabled='true' id='grid4866' originx='120.0002'
originy='310' snapvisiblegridlinesonly='true' spacingx='1px' spacingy='1px' type='xygrid' visible='true'/>
+ </sodipodi:namedview>
+ <title id='title9167'>Gnome Symbolic Icon Theme</title>
+ <defs id='defs7386'>
+ <linearGradient
gradientTransform='matrix(-2.7365795,0.28202934,-0.18908311,-0.99988321,239.54008,-879.45557)'
id='linearGradient19282' osb:paint='solid'>
+ <stop id='stop19284' offset='0' style='stop-color:#666666;stop-opacity:1;'/>
+ </linearGradient>
+ </defs>
+ <g inkscape:groupmode='layer' id='layer9' inkscape:label='status' style='display:inline'
transform='translate(-121,-527)'/>
+ <g inkscape:groupmode='layer' id='layer10' inkscape:label='devices' style='display:inline'
transform='translate(-121,-527)'>
+
+ <path inkscape:connector-curvature='0' d='m 122.0002,529 c -0.554,0 -1,0.446 -1,1 v 10 c 0,0.554 0.446,1
1,1 h 14 c 0.554,0 1,-0.446 1,-1 v -10 c 0,-0.554 -0.446,-1 -1,-1 z m 1.25,2 h 1.5 c 0.1385,0 0.25,0.1115
0.25,0.25 v 1.5 c 0,0.1385 -0.1115,0.25 -0.25,0.25 h -1.5 c -0.1385,0 -0.25,-0.1115 -0.25,-0.25 v -1.5 c
0,-0.1385 0.1115,-0.25 0.25,-0.25 z m 3,0 h 1.5 c 0.1385,0 0.25,0.1115 0.25,0.25 v 1.5 c 0,0.1385
-0.1115,0.25 -0.25,0.25 h -1.5 c -0.1385,0 -0.25,-0.1115 -0.25,-0.25 v -1.5 c 0,-0.1385 0.1115,-0.25
0.25,-0.25 z m 3,0 h 1.5 c 0.1385,0 0.25,0.1115 0.25,0.25 v 1.5 c 0,0.1385 -0.1115,0.25 -0.25,0.25 h -1.5 c
-0.1385,0 -0.25,-0.1115 -0.25,-0.25 v -1.5 c 0,-0.1385 0.1115,-0.25 0.25,-0.25 z m 3,0 h 1.5 c 0.1385,0
0.25,0.1115 0.25,0.25 v 1.5 c 0,0.1385 -0.1115,0.25 -0.25,0.25 h -1.5 c -0.1385,0 -0.25,-0.1115 -0.25,-0.25 v
-1.5 c 0,-0.1385 0.1115,-0.25 0.25,-0.25 z m -8,3 h 1.5 c 0.1385,0 0.25,0.1115 0.25,0.25 v 1.5 c 0,0.1385
-0.1115,0.25 -0.25,0.25 h -1.5 c -0.1385,0
-0.25,-0.1115 -0.25,-0.25 v -1.5 c 0,-0.1385 0.1115,-0.25 0.25,-0.25 z m 3,0 h 1.5 c 0.1385,0 0.25,0.1115
0.25,0.25 v 1.5 c 0,0.1385 -0.1115,0.25 -0.25,0.25 h -1.5 c -0.1385,0 -0.25,-0.1115 -0.25,-0.25 v -1.5 c
0,-0.1385 0.1115,-0.25 0.25,-0.25 z m 3,0 h 1.5 c 0.1385,0 0.25,0.1115 0.25,0.25 v 1.5 c 0,0.1385
-0.1115,0.25 -0.25,0.25 h -1.5 c -0.1385,0 -0.25,-0.1115 -0.25,-0.25 v -1.5 c 0,-0.1385 0.1115,-0.25
0.25,-0.25 z m 3,0 h 1.5 c 0.1385,0 0.25,0.1115 0.25,0.25 v 1.5 c 0,0.1385 -0.1115,0.25 -0.25,0.25 h -1.5 c
-0.1385,0 -0.25,-0.1115 -0.25,-0.25 v -1.5 c 0,-0.1385 0.1115,-0.25 0.25,-0.25 z m -10,3 h 1.5 c 0.1385,0
0.25,0.1115 0.25,0.25 v 1.5 c 0,0.1385 -0.1115,0.25 -0.25,0.25 h -1.5 c -0.1385,0 -0.25,-0.1115 -0.25,-0.25 v
-1.5 c 0,-0.1385 0.1115,-0.25 0.25,-0.25 z m 3,0 h 5.5 c 0.1385,0 0.25,0.1115 0.25,0.25 v 1.5 c 0,0.1385
-0.1115,0.25 -0.25,0.25 h -5.5 c -0.1385,0 -0.25,-0.1115 -0.25,-0.25 v -1.5 c 0,-0.1385 0.1115,-0.25
0.25,-0.25 z m 7,0 h 2.5 c 0.1385,0 0.25,0.1115
0.25,0.25 v 1.5 c 0,0.1385 -0.1115,0.25 -0.25,0.25 h -2.5 c -0.1385,0 -0.25,-0.1115 -0.25,-0.25 v -1.5 c
0,-0.1385 0.1115,-0.25 0.25,-0.25 z' id='rect4890'
style='color:#bebebe;display:inline;overflow:visible;visibility:visible;fill:#bebebe;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:3;marker:none;enable-background:accumulate'/>
+ </g>
+ <g inkscape:groupmode='layer' id='layer11' inkscape:label='apps' transform='translate(-121,-527)'/>
+ <g inkscape:groupmode='layer' id='layer13' inkscape:label='places' style='display:inline'
transform='translate(-121,-527)'/>
+ <g inkscape:groupmode='layer' id='layer14' inkscape:label='mimetypes' transform='translate(-121,-527)'/>
+ <g inkscape:groupmode='layer' id='layer15' inkscape:label='emblems' style='display:inline'
transform='translate(-121,-527)'/>
+ <g inkscape:groupmode='layer' id='g71291' inkscape:label='emotes' style='display:inline'
transform='translate(-121,-527)'/>
+ <g inkscape:groupmode='layer' id='g4953' inkscape:label='categories' style='display:inline'
transform='translate(-121,-527)'/>
+ <g inkscape:groupmode='layer' id='layer12' inkscape:label='actions' style='display:inline'
transform='translate(-121,-527)'/>
+</svg>
diff --git a/help/C/figures/open-menu-symbolic.svg b/help/C/figures/open-menu-symbolic.svg
new file mode 100644
index 0000000..35f8ee5
--- /dev/null
+++ b/help/C/figures/open-menu-symbolic.svg
@@ -0,0 +1,33 @@
+<?xml version='1.0' encoding='UTF-8' standalone='no'?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg xmlns:cc='http://creativecommons.org/ns#' xmlns:dc='http://purl.org/dc/elements/1.1/'
sodipodi:docname='open-menu-symbolic.svg'
inkscape:export-filename='/home/sam/dev/RESOURCES/gnome-icon-theme-symbolic/src/gnome-stencils.png'
inkscape:export-xdpi='90' inkscape:export-ydpi='90' height='16' id='svg7384'
xmlns:inkscape='http://www.inkscape.org/namespaces/inkscape'
xmlns:rdf='http://www.w3.org/1999/02/22-rdf-syntax-ns#'
xmlns:sodipodi='http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd' xmlns:svg='http://www.w3.org/2000/svg'
version='1.1' inkscape:version='0.48.4 r9939' width='16' xmlns='http://www.w3.org/2000/svg'>
+ <metadata id='metadata90'>
+ <rdf:RDF>
+ <cc:Work rdf:about=''>
+ <dc:format>image/svg+xml</dc:format>
+ <dc:type rdf:resource='http://purl.org/dc/dcmitype/StillImage'/>
+ <dc:title>Gnome Symbolic Icon Theme</dc:title>
+ </cc:Work>
+ </rdf:RDF>
+ </metadata>
+ <sodipodi:namedview inkscape:bbox-nodes='false' inkscape:bbox-paths='true' bordercolor='#666666'
borderopacity='1' inkscape:current-layer='layer12' inkscape:cx='584.66783' inkscape:cy='457.29496'
gridtolerance='10' inkscape:guide-bbox='true' guidetolerance='10' id='namedview88'
inkscape:object-nodes='false' inkscape:object-paths='false' objecttolerance='10' pagecolor='#3a3b39'
inkscape:pageopacity='1' inkscape:pageshadow='2' showborder='false' showgrid='false' showguides='true'
inkscape:snap-bbox='true' inkscape:snap-bbox-midpoints='false' inkscape:snap-global='true'
inkscape:snap-grids='true' inkscape:snap-nodes='true' inkscape:snap-others='false'
inkscape:snap-to-guides='true' inkscape:window-height='1374' inkscape:window-maximized='1'
inkscape:window-width='2560' inkscape:window-x='0' inkscape:window-y='27' inkscape:zoom='1'>
+ <inkscape:grid dotted='false' empspacing='2' enabled='true' id='grid4866' originx='180px'
originy='732.00001px' snapvisiblegridlinesonly='true' spacingx='1px' spacingy='1px' type='xygrid'
visible='true'/>
+ </sodipodi:namedview>
+ <title id='title9167'>Gnome Symbolic Icon Theme</title>
+ <defs id='defs7386'/>
+ <g inkscape:groupmode='layer' id='layer9' inkscape:label='status' style='display:inline'
transform='translate(-61.0002,-949.00001)'/>
+ <g inkscape:groupmode='layer' id='layer10' inkscape:label='devices' style='display:inline'
transform='translate(-61.0002,-949.00001)'/>
+ <g inkscape:groupmode='layer' id='layer11' inkscape:label='apps'
transform='translate(-61.0002,-949.00001)'/>
+ <g inkscape:groupmode='layer' id='layer13' inkscape:label='places' style='display:inline'
transform='translate(-61.0002,-949.00001)'/>
+ <g inkscape:groupmode='layer' id='layer14' inkscape:label='mimetypes'
transform='translate(-61.0002,-949.00001)'/>
+ <g inkscape:groupmode='layer' id='layer15' inkscape:label='emblems' style='display:inline'
transform='translate(-61.0002,-949.00001)'/>
+ <g inkscape:groupmode='layer' id='g71291' inkscape:label='emotes' style='display:inline'
transform='translate(-61.0002,-949.00001)'/>
+ <g inkscape:groupmode='layer' id='g4953' inkscape:label='categories' style='display:inline'
transform='translate(-61.0002,-949.00001)'/>
+ <g inkscape:groupmode='layer' id='layer12' inkscape:label='actions' style='display:inline'
transform='translate(-61.0002,-949.00001)'>
+
+ <rect height='2.0002136' id='rect7356' inkscape:label='a'
style='color:#bebebe;fill:#bebebe;fill-opacity:1;stroke:none;stroke-width:1;marker:none;visibility:visible;display:inline;overflow:visible'
width='9.9996014' x='64.000397' y='951.99982'/>
+ <rect height='2.0002136' id='rect7358' inkscape:label='a'
style='color:#bebebe;fill:#bebebe;fill-opacity:1;stroke:none;stroke-width:1;marker:none;visibility:visible;display:inline;overflow:visible'
width='9.9996014' x='64.000397' y='955.99982'/>
+ <rect height='2.0002136' id='rect7360' inkscape:label='a'
style='color:#bebebe;fill:#bebebe;fill-opacity:1;stroke:none;stroke-width:1;marker:none;visibility:visible;display:inline;overflow:visible'
width='9.9996014' x='64.000397' y='959.99982'/>
+ </g>
+</svg>
diff --git a/help/C/interface.page b/help/C/interface.page
index 60740ec..6bffa30 100644
--- a/help/C/interface.page
+++ b/help/C/interface.page
@@ -1,9 +1,11 @@
<page xmlns="http://projectmallard.org/1.0/";
+ xmlns:its="http://www.w3.org/2005/11/its";
type="topic" style="task"
id="interface">
<info>
<revision pkgversion="3.8.0" date="2013-03-23" status="candidate"/>
<revision pkgversion="3.14" date="2014-09-13" status="review"/>
+ <revision pkgversion="3.24.0" date="2017-05-02" status="review"/>
<link type="guide" xref="index#use" group="#first" />
<credit type="author copyright">
@@ -33,8 +35,12 @@
<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
+ <item><p>Click the checkmark button in the header bar to enter selection
mode.</p></item>
+ <item><p>Right click on a box to choose <gui>Open in New Window</gui>,
+ <gui>Add to Favorites</gui>, <gui>Force Shutdown</gui>, <gui>Pause</gui>,
+ <gui>Clone</gui>, <gui>Delete</gui>, or to open the <gui>Properties</gui>
+ view for the box.</p></item>
</list>
</section>
@@ -59,8 +65,6 @@
<item><p>Mark a box or boxes as favorites.</p></item>
<item><p>Pause a box.</p></item>
<item><p>Open a box in a new window.</p></item>
- <item><p>Click the <gui style="button">Properties</gui> button to enter the
- properties view of a box.</p></item>
</list>
</section>
@@ -68,36 +72,39 @@
<section id="properties">
<title>Properties view</title>
- <p>Clicking the <gui style="button">Properties</gui> button in selection mode
- 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>
+ <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
+ or change settings depending on which of the following tabs is selected:</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>: <link xref="snapshot-create">creating</link>
- and managing snapshots of the box.</p></item>
+ <item><p><gui>General</gui>: displays the box <gui>Name</gui> and
+ <gui>Broker</gui> or virtualizer being used (such as <em>QEMU</em>). For a
+ remote box, this tab also displays the <gui>Protocol</gui> (such as
+ <em>VNC</em>), the <gui>URL</gui> to be used for remote access, and a
+ switch to make the connection <gui>Read-only</gui>. When the box is
+ running, the <gui>Share Clipboard</gui> switch 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</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.</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>
<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>
+ <gui style="button">Customize</gui> button during local box setup. If the box
+ is running, click the menu (<media its:translate="no" type="image"
src="figures/open-menu-symbolic.svg"><span its:translate="yes">settings</span></media>)
+ button in the header bar and select <gui>Properties</gui>.</p>
</section>
diff --git a/help/C/keystrokes.page b/help/C/keystrokes.page
new file mode 100644
index 0000000..dfa1f19
--- /dev/null
+++ b/help/C/keystrokes.page
@@ -0,0 +1,53 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ xmlns:its="http://www.w3.org/2005/11/its";
+ type="topic" style="task"
+ id="keystrokes">
+ <info>
+ <revision pkgversion="3.24.0" date="2017-05-02" status="review"/>
+ <link type="guide" xref="index#use"/>
+
+ <credit type="author copyright">
+ <name>Michael Hill</name>
+ <email>mdhillca gmail com</email>
+ <years>2017</years>
+ </credit>
+
+ <desc>Keystroke combinations can be sent from the menu.</desc>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ </info>
+
+ <title>Send a keystroke combination to a box</title>
+
+ <p>Some combinations of keystrokes are automatically directed to the host
+ machine. To send a key sequence instead to the running guest:</p>
+
+ <steps>
+ <item><p>Click the keyboard
+ (<media its:translate="no" type="image" src="figures/input-keyboard-symbolic.svg
+"><span its:translate="yes">settings</span></media>)
+ button in the header bar.</p></item>
+ <item><p>Click the key combination you want to send. The available key
+ combinations are:</p>
+ <list>
+ <item><p><keyseq><key>Ctrl</key><key>Alt</key><key>Backspace</key></keyseq></p></item>
+ <item><p><keyseq><key>Ctrl</key><key>Alt</key><key>F1</key></keyseq></p></item>
+ <item><p><keyseq><key>Ctrl</key><key>Alt</key><key>F2</key></keyseq></p></item>
+ <item><p><keyseq><key>Ctrl</key><key>Alt</key><key>F3</key></keyseq></p></item>
+ <item><p><keyseq><key>Ctrl</key><key>Alt</key><key>F7</key></keyseq></p></item>
+ </list></item>
+
+ </steps>
+
+ <note style="info">
+ <p>If your guest operating system is Linux, you can often use one of these
+ key sequences to switch to the first virtual console, and another to switch
+ back to the graphical console. In a number of Linux distributions,
+ <keyseq><key>Ctrl</key><key>Alt</key><key>F3</key></keyseq> will switch to
+ the virtual console, and
+ <keyseq><key>Ctrl</key><key>Alt</key><key>F1</key></keyseq> will switch
+ back to the graphical desktop.</p>
+ </note>
+
+</page>
diff --git a/help/C/prop-system.page b/help/C/prop-system.page
index 0ec5a0f..c2511c3 100644
--- a/help/C/prop-system.page
+++ b/help/C/prop-system.page
@@ -1,8 +1,10 @@
<page xmlns="http://projectmallard.org/1.0/";
+ xmlns:its="http://www.w3.org/2005/11/its";
type="topic" style="task"
id="prop-system">
<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" />
<credit type="author copyright">
@@ -20,13 +22,12 @@
maximum allocated disk space.</p>
<steps>
- <item><p>Open the <link xref="interface#properties">properties view</link>
- for the box. If the box is open, click the
- <gui style="button">Properties</gui> button in the header bar. The
- properties view can also be accessed from
- <link xref="interface#selection">selection mode</link>.</p></item>
- <item><p>Click <gui>System</gui> in the sidebar.</p></item>
- <item><p>Adjust the <gui>Memory</gui> and <gui>Maximum disk space</gui>
+ <item><p>Right-click on the box in the collection view and select
+ <gui>Properties</gui>, or if the box is running, click the menu
+ (<media its:translate="no" type="image" src="figures/open-menu-symbolic.svg"><span
its:translate="yes">settings</span></media>)
+ button in the header bar and select <gui>Properties</gui>.</p></item>
+ <item><p>Click the <gui>System</gui> tab.</p></item>
+ <item><p>Adjust the <gui>Memory</gui> and <gui>Maximum disk size</gui>
sliders to reflect the desired values.</p></item>
</steps>
diff --git a/help/C/prop-trouble.page b/help/C/prop-trouble.page
index 9f0b73b..53a801d 100644
--- a/help/C/prop-trouble.page
+++ b/help/C/prop-trouble.page
@@ -1,8 +1,10 @@
<page xmlns="http://projectmallard.org/1.0/";
+ xmlns:its="http://www.w3.org/2005/11/its";
type="topic" style="task"
id="prop-trouble">
<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"/>
<credit type="author copyright">
@@ -14,7 +16,7 @@
<desc>Diagnose problems with your box using the log file.</desc>
</info>
- <title>View the trouble log of a box</title>
+ <title>View the troubleshooting log of a box</title>
<p>If a box is having a problem starting up or running, clues to help you fix
the problem may be found in the trouble log. The trouble log displays the
@@ -22,14 +24,13 @@
QEMU hypervisor log.</p>
<steps>
- <item><p>Open the <link xref="interface#properties">properties view</link>
- for the box. If the box is open, click the
- <gui style="button">Properties</gui> button in the header bar. The
- properties view can also be accessed from
- <link xref="interface#selection">selection mode</link>.</p></item>
- <item><p>Click <gui>System</gui> in the sidebar.</p></item>
- <item><p>Click the <gui style="button">Trouble Log</gui> button to view the
- log.</p></item>
+ <item><p>Right-click on the box in the collection view and select
+ <gui>Properties</gui>, or if the box is running, click the menu
+ (<media its:translate="no" type="image" src="figures/open-menu-symbolic.svg"><span
its:translate="yes">settings</span></media>)
+ button in the header bar and select <gui>Properties</gui>.</p></item>
+ <item><p>Click the <gui>System</gui> tab.</p></item>
+ <item><p>Click the <gui style="button">Troubleshooting Log</gui> button to
+ view the log.</p></item>
</steps>
</page>
diff --git a/help/C/shutdown.page b/help/C/shutdown.page
index 165360f..ccb3af9 100644
--- a/help/C/shutdown.page
+++ b/help/C/shutdown.page
@@ -1,8 +1,10 @@
<page xmlns="http://projectmallard.org/1.0/";
+ xmlns:its="http://www.w3.org/2005/11/its";
type="topic" style="task"
id="shutdown">
<info>
<revision pkgversion="3.14" date="2014-09-13" status="review"/>
+ <revision pkgversion="3.24.0" date="2017-05-02" status="review"/>
<link type="guide" xref="index#use"/>
<credit type="author copyright">
@@ -22,13 +24,11 @@
<steps>
<item><p>Open the <link xref="interface#properties">properties view</link>
- for the box. If the box is open, click the
- <gui style="button">Properties</gui> button in the header bar. The
- properties view can also be accessed from
- <link xref="interface#selection">selection mode</link>.</p></item>
- <item><p>Click <gui style="button">Force Shutdown</gui> in the lower left
- corner.</p></item>
- <item><p>Click <gui style="button">Shutdown</gui> to confirm.</p></item>
+ for the box. If the box is running, click the menu
+ (<media its:translate="no" type="image" src="figures/open-menu-symbolic.svg"><span
its:translate="yes">settings</span></media>)
+ button in the header bar and select <gui>Properties</gui>.</p></item>
+ <item><p>Click the <gui>System</gui> tab.</p></item>
+ <item><p>Click the <gui style="button">Force Shutdown</gui> button.</p></item>
</steps>
</page>
diff --git a/help/C/snapshot-create.page b/help/C/snapshot-create.page
index dc5449a..d3e9eec 100644
--- a/help/C/snapshot-create.page
+++ b/help/C/snapshot-create.page
@@ -1,8 +1,10 @@
<page xmlns="http://projectmallard.org/1.0/";
+ xmlns:its="http://www.w3.org/2005/11/its";
type="topic" style="task"
id="snapshot-create">
<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#snapshots" group="#first" />
<credit type="author copyright">
@@ -22,12 +24,11 @@
state so you can return to it as often as you want.</p>
<steps>
- <item><p>Open the <link xref="interface#properties">properties view</link>
- for the box. If the box is open, click the
- <gui style="button">Properties</gui> button in the header bar. The
- properties view can also be accessed from
- <link xref="interface#selection">selection mode</link>.</p></item>
- <item><p>Click <gui>Snapshots</gui> in the sidebar.</p></item>
+ <item><p>Right-click on the box in the collection view and select
+ <gui>Properties</gui>, or if the box is running, click the menu
+ (<media its:translate="no" type="image" src="figures/open-menu-symbolic.svg"><span
its:translate="yes">settings</span></media>)
+ button in the header bar and select <gui>Properties</gui>.</p></item>
+ <item><p>Click the <gui>Snapshots</gui> tab.</p></item>
<item><p>Click <key>+</key> below the <gui>Snapshots</gui> list.</p></item>
</steps>
diff --git a/help/C/snapshot-delete.page b/help/C/snapshot-delete.page
index d165c77..7980bb4 100644
--- a/help/C/snapshot-delete.page
+++ b/help/C/snapshot-delete.page
@@ -1,8 +1,10 @@
<page xmlns="http://projectmallard.org/1.0/";
+ xmlns:its="http://www.w3.org/2005/11/its";
type="topic" style="task"
id="snapshot-delete">
<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#snapshots"/>
<credit type="author copyright">
@@ -19,16 +21,14 @@
<p>A snapshot that is no longer needed can be removed from the list.</p>
<steps>
- <item><p>Open the <link xref="interface#properties">properties view</link>
- for the box. If the box is open, click the
- <gui style="button">Properties</gui> button in the header bar. The
- properties view can also be accessed from
- <link xref="interface#selection">selection mode</link>.</p></item>
- <item><p>Click <gui>Snapshots</gui> in the sidebar.</p></item>
+ <item><p>Right-click on the box in the collection view and select
+ <gui>Properties</gui>, or if the box is running, click the menu
+ (<media its:translate="no" type="image" src="figures/open-menu-symbolic.svg"><span
its:translate="yes">settings</span></media>)
+ button in the header bar and select <gui>Properties</gui>.</p></item>
+ <item><p>Click the <gui>Snapshots</gui> tab.</p></item>
<item><p>Select the snapshot to be deleted from the list.</p></item>
- <item><p>Click the menu button on the right and select
+ <item><p>Click the gear button on the right and select
<gui>Delete</gui>.</p></item>
- <item><p>Confirm to permanently delete the snapshot.</p></item>
</steps>
</page>
diff --git a/help/C/snapshot-rename.page b/help/C/snapshot-rename.page
index ae1810f..7c66b75 100644
--- a/help/C/snapshot-rename.page
+++ b/help/C/snapshot-rename.page
@@ -1,8 +1,10 @@
<page xmlns="http://projectmallard.org/1.0/";
+ xmlns:its="http://www.w3.org/2005/11/its";
type="topic" style="task"
id="snapshot-rename">
<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#snapshots"/>
<credit type="author copyright">
@@ -27,16 +29,16 @@
<file>Windows 7 plus GTK+ 3.6.4</file>.</p>
<steps>
- <item><p>Open the <link xref="interface#properties">properties view</link>
- for the box. If the box is open, click the
- <gui style="button">Properties</gui> button in the header bar. The
- properties view can also be accessed from
- <link xref="interface#selection">selection mode</link>.</p></item>
- <item><p>Click <gui>Snapshots</gui> in the sidebar.</p></item>
- <item><p>Select the snapshot to be renamed from the list.</p></item>
- <item><p>Click the menu button on the right and select
+ <item><p>Right-click on the box in the collection view and select
+ <gui>Properties</gui>, or if the box is running, click the menu
+ (<media its:translate="no" type="image" src="figures/open-menu-symbolic.svg"><span
its:translate="yes">settings</span></media>)
+ button in the header bar and select <gui>Properties</gui>.</p></item>
+ <item><p>Click the <gui>Snapshots</gui> tab.</p></item>
+ <item><p>From the list, select the snapshot to be renamed.</p></item>
+ <item><p>Click the gear button on the right and select
<gui>Rename</gui>.</p></item>
- <item><p>Type the desired name and press <key>Enter</key>.</p></item>
+ <item><p>Type the desired name and press
+ <gui style="button">Done</gui>.</p></item>
</steps>
</page>
diff --git a/help/C/snapshot-revert.page b/help/C/snapshot-revert.page
index 360336f..841dc1b 100644
--- a/help/C/snapshot-revert.page
+++ b/help/C/snapshot-revert.page
@@ -1,8 +1,10 @@
<page xmlns="http://projectmallard.org/1.0/";
+ xmlns:its="http://www.w3.org/2005/11/its";
type="topic" style="task"
id="snapshot-revert">
<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#snapshots"/>
<credit type="author copyright">
@@ -20,14 +22,14 @@
saved in that snapshot.</p>
<steps>
- <item><p>Open the <link xref="interface#properties">properties view</link>
- for the box. If the box is open, click the
- <gui style="button">Properties</gui> button in the header bar. The
- properties view can also be accessed from
- <link xref="interface#selection">selection mode</link>.</p></item>
- <item><p>Click <gui>Snapshots</gui> in the sidebar.</p></item>
- <item><p>Select the snapshot from the list to which to revert.</p></item>
- <item><p>Click the menu button on the right and select
+ <item><p>Right-click on the box in the collection view and select
+ <gui>Properties</gui>, or if the box is running, click the menu
+ (<media its:translate="no" type="image" src="figures/open-menu-symbolic.svg"><span
its:translate="yes">settings</span></media>)
+ button in the header bar and select <gui>Properties</gui>.</p></item>
+ <item><p>Click the <gui>Snapshots</gui> tab.</p></item>
+ <item><p>From the list, select the snapshot to which you want to
+ revert.</p></item>
+ <item><p>Click the gear button on the right and select
<gui>Revert to this state</gui>.</p></item>
</steps>
diff --git a/help/C/usb-redirection.page b/help/C/usb-redirection.page
index d699661..2e2d599 100644
--- a/help/C/usb-redirection.page
+++ b/help/C/usb-redirection.page
@@ -1,9 +1,11 @@
<page xmlns="http://projectmallard.org/1.0/";
+ xmlns:its="http://www.w3.org/2005/11/its";
type="topic" style="task"
id="usb-redirection">
<info>
<revision pkgversion="3.8.0" version="0.1" date="2013-03-24" status="candidate"/>
+ <revision pkgversion="3.24.0" date="2017-05-02" status="review"/>
<link type="guide" xref="index#use"/>
@@ -34,13 +36,13 @@
<steps>
<title>To enable host USB devices in a box:</title>
- <item><p>Right-click on the box in the collection view, or if the box is
- already open, click the properties button in the toolbar.</p></item>
- <item><p>Click <gui style="menuitem">Devices</gui> in the sidebar.</p></item>
- <item><p>Ensure <gui>Redirect new USB devices</gui> is switched to
- <gui style="switch">ON</gui>. <gui>USB devices</gui> connected to the host
- machine are shown in a list.</p></item>
- <item><p>Set the switch next to each desired device to
+ <item><p>Right-click on the box in the collection view and select
+ <gui>Properties</gui>, or if the box is running, click the menu
+ (<media its:translate="no" type="image" src="figures/open-menu-symbolic.svg"><span
its:translate="yes">settings</span></media>)
+ button in the header bar and select <gui>Properties</gui>.</p></item>
+ <item><p>Click the <gui>Devices</gui> tab.</p></item>
+ <item><p><gui>USB devices</gui> connected to the host
+ machine are shown in a list. Set the switch next to each desired device to
<gui style="switch">ON</gui>.</p></item>
</steps>
diff --git a/help/Makefile.am b/help/Makefile.am
index 5719252..850d72f 100644
--- a/help/Makefile.am
+++ b/help/Makefile.am
@@ -2,7 +2,9 @@
HELP_ID = gnome-boxes
-HELP_MEDIA = figures/boxes_icon.png
+HELP_MEDIA = figures/boxes_icon.png \
+ figures/input-keyboard-symbolic.svg \
+ figures/open-menu-symbolic.svg
HELP_FILES = index.page \
clipboard.page \
@@ -12,6 +14,7 @@ HELP_FILES = index.page \
delete.page \
disk-images.page \
interface.page \
+ keystrokes.page \
legal.xml \
prop-system.page \
prop-trouble.page \
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
