Made Boxes into it's own chapter and fixed tags and worked on the indenting of the xml for Boxes.xml

1 files changed, 178 insertions, 28 deletions

diff --git a/en-US/Boxes.xml b/en-US/Boxes.xml
index 368a3fb..dcb64b4 100644
--- a/en-US/Boxes.xml
+++ b/en-US/Boxes.xml
@@ -1,31 +1,181 @@
 <?xml version='1.0' encoding='utf-8' ?>
 <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
 ]>
-<chapter>
-	<title>Creating a Virtual Machine in Boxes</title>
-<orderedlist>
-	  <listitem><para>First, Download an ISO of an operating system you would like to use for your virtual machine. A Live CD Iso usually works well for this. Download the ISO to your Downloads folder this is where Boxes will look for ISO files you have downloaded.
-		</para></listitem>
-		<listitem><para>Press the Super Key, and type the word Boxes, this will bring up the Boxes Icon, it looks like a 3-d wireframe box. Click on the icon.</para></listitem>
-<listitem><para>Click the New Button in the upper left hand corner</para></listitem>
-<listitem><para>Read the introduction and click continue in the upper right hand corner</para></listitem>
-<listitem><para>Select the ISO Image you have downloaded to your Downloads folder, otherwise click "select a file" to find one somewhere else </para></listitem>
-<listitem><para>Boxes will then auto create settings for you, if you wish to change them click "customize" </para></listitem>
-<listitem><para>If you click "customize" you can change the memory and disk space given to the virtual machine</para></listitem>
-<listitem><para>Click Create</para></listitem>
-</orderedlist>
-<para> The new virtual machine will now boot</para>
-<para> Virtual machine settings can be changed by clicking on the <emphasis>screwdriver/wrench icon </emphasis> in the top Right hand side of the menu bar like:
-</para>
-<itemizedlist>
-<listitem><para>Sharing the clipboard</para></listitem>
-<listitem><para>Resize Guest</para></listitem>
-<listitem><para>Redirect New USB Devices to the Virtual Machine</para></listitem>
-<listitem><para>Redirect currently plugged in USB devices to the Virtual machine</para></listitem>
-<listitem><para>Create Snapshots of the Virtual Machine from the snapshot heading</para></listitem>
-<listitem><para>Force Shutdown, by clicking "Force Shutdown" in the lower left hand corner</para></listitem>
-</itemizedlist>
-<para> To exit the settings menu, <emphasis>press the arrow pointing "back" or to the left on the top left hand side of the menu bar</emphasis>. This will return you to your virtual machine console
-</para>
-
-</chapter>
+<chapter id="Intro_Boxes">
+		<title>Introduction to Boxes</title>
+		<para>
+			Boxes is a simple graphical interface for managing and using virtual machines.
+		</para>
+		<para>
+			Boxes uses <application>qemu-kvm</application>, <application>libvirt-glib</application>, and <application>spice-gtk</application> to allow users to easily manage virtual machines and connect to remote machines
+		</para>
+<section id="sec-boxes-Features">
+	<title>Features of Boxes</title>
+		<itemizedlist>
+			<listitem><para>Create, access, and manage, local virtual machines</para></listitem>
+			<listitem><para>Connect to remote machines (called connections) via SPICE, Quemu, or VNC protocols</para></listitem>
+			<listitem><para>Select and create favorite virtual machines or connections </para></listitem>		
+		</itemizedlist>
+</section>
+<section id="sec-handy-boxes-notes">
+	<title>Handy Notes about Boxes</title>
+			<itemizedlist>
+				<listitem>
+					<para>Boxes uses <application>libvertd</application> and many <application>libvertd</application> commands can be used for Boxes virtual machines
+				</para>			
+			</listitem>
+			<listitem>
+				<para>Boxes keeps the virtual machine disks or images in:<filename class="directory">/home/$USER/.local/share/gnome-boxes/images
+			</filename>
+				</para>		
+			</listitem>
+				<listitem>
+					<para>Boxes keeps the configuration files for virtual machines in:<filename class="directory">/home/$USER/.config/share/gnome-boxes
+			</filename>
+				</para>			
+			</listitem>
+		</itemizedlist>
+		</section> 
+<section id="sec-create-vm-in-boxes">
+	<title>Create a Virtual Machine In Boxes</title>
+		<procedure><title>Create a Virtual Machine In Boxes</title>
+			<step>
+ 				<para>
+ 					 Download an ISO image of an operating system that will be used in the virtual machine
+ 				</para>
+			</step>
+			<step>
+ 				<para>
+ 					Launch Boxes from the application launcher, super key, or terminal
+ 				</para>
+			</step>
+			<step>
+ 				<para>
+ 					Click the <guilabel>New</guilabel> Button
+ 				</para>
+			</step>
+			<step>
+ 				<para>
+ 					Read the introduction and click <guilabel>continue</guilabel> in the upper right hand corner
+ 				</para>
+			</step>
+			<step>
+ 				<para>
+ 					Select the ISO Image that was previously downloaded to the Downloads folder, otherwise click <guilabel>select a file</guilabel> to find one somewhere else
+ 				</para>
+			</step>
+			<step>
+ 				<para>
+ 					Boxes will then auto create settings, they can be edited by clicking <guilabel>customize</guilabel>
+ 				</para>
+			</step>
+			<step>
+ 				<para>
+ 					Memory and Disk allocation can be changed via the customize menu.
+ 				</para>
+			</step>
+			<step>
+ 				<para>
+ 					Click <guilabel>Create</guilabel>
+ 				</para>
+			</step>
+			<step>
+ 				<para>
+ 					The new virtual machine will now boot
+			 	</para>
+			</step>
+		</procedure>
+</section>
+<section id="sec-options-available-created-vm">
+	<title>Options available in a Boxes virtual machine</title>
+		<note>
+			<para> 
+				Virtual machine settings can be changed by clicking on the <guilabel>screwdriver/wrench icon</guilabel> to access:
+			</para>
+		</note>
+	<itemizedlist>
+		<listitem><para>Sharing the clipboard</para></listitem>
+		<listitem><para>Resize Guest</para></listitem>
+		<listitem><para>Redirect New USB Devices to the Virtual Machine</para></listitem>
+		<listitem><para>Redirect currently plugged in USB devices to the Virtual machine</para></listitem>
+		<listitem><para>Create Snapshots of the Virtual Machine from the snapshot heading</para></listitem>
+		<listitem><para>Force Shutdown, by clicking "Force Shutdown" in the lower left hand corner</para></listitem>
+	</itemizedlist>
+	<para> 
+		To exit the settings menu, <emphasis>press the arrow pointing <guilabel>back</guilabel> or to the left on the top left hand side of the menu bar</emphasis>. This will return you to your virtual machine console
+	</para>
+</section>
+<section id="sec-connect-to-remote-machine">
+	<title>How to connect to remote machines via Boxes</title>
+	<note>
+		<para>Boxes Supports three protocols: SPICE, Qemu, and VNC</para>
+	</note>
+	<procedure>
+		<title>Connect to a remote machine in Boxes</title>
+		<step>
+ 			<para>
+  				Open Boxes
+ 			</para>
+		</step>
+		<step>
+ 			<para>
+  				Click Continue while the introduction is displayed
+ 			</para>
+		</step>
+		<step>
+ 			<para>
+  				Click Enter URL
+ 			</para>
+		</step>
+		<step>
+ 			<para>
+  				Enter the IP address or hostname of the remote machine you want to connect to. Remember to specify the protocol in the field. For example to connect to a computer via VNC at IP Address 192.168.1.115, you would input vnc://192.168.1.115
+ 			</para>
+		</step>
+		<step>
+ 			<para>
+  				Click Continue
+ 			</para>
+		</step>
+		<step>
+ 			<para>
+  				The Review screen will now show you the type (protocol) and host (either hostname or IP address) of the remote connection. 
+ 			</para>
+		</step>
+		<step>
+ 			<para>
+  				You can click customize at this screen to access different options that are available per protocol, for example USB redirection is available for the spice protocol. Or Read only is available for VNC.
+ 			</para>
+		</step>
+		<step>
+ 			<para>
+  				Click Create
+ 			</para>
+		</step>
+		<step>
+ 			<para>
+  				The Remote connection is now available in the selection screen.
+ 			</para>
+		</step>
+		</procedure>
+		</section>
+<section id="sec-libvirt-boxes">
+			 <title>Libvirt tools useful in boxes</title>
+				<para>
+					You can start and stop virtual machines from the command line as well as using the boxes interface 
+				</para>
+					<itemizedlist>
+						<listitem>
+							<para><command>virsh shutdown</command> or<command> virsh reboot</command> will use ACPI to shutdown or reboot the virtual machine</para></listitem>
+						<listitem>
+							<para><command>virsh destroy</command> will mimic if you pulled the power from a running virtual machine.</para></listitem>
+						<listitem>
+							<para><command>virsh start</command> will power on or start the virtual machine</para></listitem>
+					</itemizedlist>
+		<warning> 
+			<para>
+				Do not use the <command>virsh destory</command> often or corruption and data loss will likely occur 
+			</para>				
+		</warning>												
+</section>
+</chapter>
\ No newline at end of file