[system-administrators-guide/21] Improve TigerVNC

[stephenw]

commit 89b5e99c2792bf14a994b2e176ecd3dc2fd89c26
Author: Stephen Wadeley <swadeley at redhat.com>
Date:   Thu Feb 5 19:26:05 2015 +0100

    Improve TigerVNC

 en-US/TigerVNC.xml |   24 +++++++++++++-----------
 1 files changed, 13 insertions(+), 11 deletions(-)
---
diff --git a/en-US/TigerVNC.xml b/en-US/TigerVNC.xml
index 447544b..edf76e6 100644
--- a/en-US/TigerVNC.xml
+++ b/en-US/TigerVNC.xml
@@ -23,7 +23,7 @@ by <filename>/etc/systemd/system/vncserver at .service</filename>.
     <title>VNC Server</title>
     		<para>
 <systemitem>vncserver</systemitem> is a utility which starts a VNC (Virtual
-Network Computing) desktop. It runs Xvnc with appropriate options and starts a window
+Network Computing) desktop. It runs <application>Xvnc</application> with appropriate options and starts a window
 manager on the VNC desktop. <systemitem>vncserver</systemitem> allows users to run
 separate sessions in parallel on a machine which can then be accessed by any number of clients
 from anywhere.
@@ -31,7 +31,7 @@ from anywhere.
   <section id="s2-vnc-installation">
     <title>Installing VNC Server</title>
 		<para>
-To install the TigerVNC server, issue the following command as <systemitem class="username">root</systemitem>:
+To install the <application>TigerVNC</application> server, issue the following command as <systemitem class="username">root</systemitem>:
 <screen><command><computeroutput>~]#&nbsp;</computeroutput><userinput>yum install tigervnc-server</userinput></command></screen>
 <!--SJW: This installs tigervnc-server and tigervnc-server-minimal, +54 Dependent packages. I now have vncserver and vncconfig man page.-->
 		</para>
@@ -96,6 +96,9 @@ file can find the plain-text password.
     </important>
         </step>
         </procedure>
+        <para>
+          Proceed to <xref linkend="s4-starting-vncserver" />.
+        </para>
         <section id="configuring-vncserver-2users">
         <title>Configuring VNC Server for Two Users</title>
         <para>
@@ -132,9 +135,9 @@ Verify:
     <title>Starting VNC Server</title>
       <para>
 To start or enable the service, specify the display number directly in the command.
-The file configured above works as a template, in which <literal>%i</literal> is substituted with
+The file configured above in <xref linkend="configuring-vncserver" /> works as a template, in which <literal>%i</literal> is substituted with
 the display number by <systemitem>systemd</systemitem>.
-With a valid number, execute the following command:
+With a valid display number, execute the following command:
       </para>
 <screen>
 <command><computeroutput>~]#&nbsp;</computeroutput>systemctl start vncserver@:<replaceable>display_number</replaceable>.service</command>
@@ -146,8 +149,7 @@ You can also enable the service to start automatically at system start. Then, wh
 <command><computeroutput>~]#&nbsp;</computeroutput>systemctl enable vncserver@:<replaceable>display_number</replaceable>.service</command>
 </screen>
 	<para>
-At this point, other users are able to use the <systemitem>vncviewer</systemitem>
-program to connect to the VNC server using the display number and password defined.
+At this point, other users are able to use a VNC viewer program to connect to the VNC server using the display number and password defined. Provided a graphical desktop is installed, an instance of that desktop will be displayed. It will not be the same instance as that currently displayed on the target machine. 
 	</para>
 	<section id="starting-vncserver-2displays">
 		<title>Configuring VNC Server for two users and two different displays</title>
@@ -190,13 +192,12 @@ user interfaces and controls the server.
 For operating the <systemitem>vncviewer</systemitem>, there is a pop-up menu
 containing entries which perform various actions such as switching in and out of
 full-screen mode or quitting the viewer. Alternatively, you can operate <systemitem>vncviewer</systemitem>
-through the terminal; there is a list of parameters <systemitem>vncviewer</systemitem>
-can be used with which you obtain by typing <command>vncviewer -h</command> on the command line.
+through the terminal. Enter <command>vncviewer -h</command> on the command line to list <systemitem>vncviewer</systemitem>'s parameters.
 </para>
   <section id="installing-vncviewer">
 		<title>Installing VNC Viewer</title>
     		<para>
-To install the TigerVNC client, referred to as <application>vncviewer</application>, issue the following command as <systemitem class="username">root</systemitem>:
+To install the <application>TigerVNC</application> client, <command>vncviewer</command>>, issue the following command as <systemitem class="username">root</systemitem>:
 <synopsis><command><computeroutput>~]#&nbsp;</computeroutput><userinput>yum install tigervnc</userinput></command></synopsis>
 		</para>
   </section>
@@ -205,7 +206,8 @@ To install the TigerVNC client, referred to as <application>vncviewer</applicati
 		<para>
 Once the VNC server is configured, you can connect to it from any VNC viewer.
 In order to do so, issue the <command>vncviewer</command> command in the following format:
-<synopsis>vncviewer <replaceable>IP_address</replaceable>:<replaceable>port_number</replaceable></synopsis>
+<synopsis>vncviewer <replaceable>address</replaceable>:<replaceable>port_number</replaceable></synopsis>
+Where <replaceable>address</replaceable> is an <systemitem class="protocol">IP</systemitem> or host name.
 		</para>
 <example id="connecting-to-vncserver">
 	<title>One Client Connecting to vncserver</title>
@@ -306,7 +308,7 @@ A port can be removed using the <command>firewall-cmd --zone=<replaceable>zone</
 <acronym>VNC</acronym> is a clear text network protocol with no security against possible attacks on the communication. To make the communication secure, you can encrypt your server-client connection by using the <option>-via</option> option. This will create an <systemitem class="protocol">SSH</systemitem> tunnel between the VNC server and the client.
 		</para>
 		<para>
-The format of the command to encrypt a VNC server-client connection looks as follows:
+The format of the command to encrypt a VNC server-client connection is as follows:
 		</para>
 <screen>
 <command><computeroutput>~]$&nbsp;</computeroutput><userinput>vncviewer -via <replaceable>user</replaceable>@<replaceable>host</replaceable>:<replaceable>display_number</replaceable></userinput></command>