[vinagre] Add help page for reverse connections, bug 597110

[David King <davidk src gnome org>]

commit 06c9e54f63d3f02ef2ecb59c6fd0b3369ebd3381
Author: Ekaterina Gerasimova <kittykat3756 googlemail com>
Date:   Sun May 1 12:00:22 2011 +0200

    Add help page for reverse connections, bug 597110

 help/C/connect.page             |    3 --
 help/C/reverse-connections.page |   59 +++++++++++++++++++++++++++++++++++++++
 help/Makefile.am                |    3 ++
 3 files changed, 62 insertions(+), 3 deletions(-)
---
diff --git a/help/C/connect.page b/help/C/connect.page
index 63936da..d6def72 100755
--- a/help/C/connect.page
+++ b/help/C/connect.page
@@ -1,5 +1,4 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      xmlns:e="http://projectmallard.org/experimental/";
       type="guide"
       id="connect">
 
@@ -66,8 +65,6 @@ to open it with <app>Vinagre</app>.</p>
 </note>
 </section>
 
-<!-- TODO: "Reverse Connections..." -->
-
 <section id="close">
   <title>Closing a connection</title>
 <p>To close a connection, choose <guiseq><gui>Remote</gui><gui>Close</gui></guiseq>.</p>
diff --git a/help/C/reverse-connections.page b/help/C/reverse-connections.page
new file mode 100644
index 0000000..a1a3e68
--- /dev/null
+++ b/help/C/reverse-connections.page
@@ -0,0 +1,59 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="guide"
+      id="reverse-connections">
+
+  <info>
+    <link type="guide" xref="index"/>
+    <link type="seealso" xref="using"/>
+    <link type="seealso" xref="connect"/>
+    <title type="sort">5</title>
+    <desc>Bypassing firewall restrictions on remote host.</desc>
+    <credit type="author">
+      <name>Ekaterina Gerasimova</name>
+      <email>kittykat3756 googlemail com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+  </info>
+
+<title>Reverse Connectionsâ?¦</title>
+
+<p>A reverse connection is usually used to bypass firewall restrictions on open
+ports. A firewall usually blocks open ports, but does not block outgoing
+traffic. In a normal forward connection, a client connects to a server through
+the server's open port, but in the case of a reverse connection, the client
+opens the port that the server connects to.</p>
+
+<section id="enable-reverse-connections">
+  <title>Enabling reverse connections</title>
+<p>Open <guiseq><gui>Remote</gui><gui>Reverse Connections...</gui></guiseq> and
+select <gui>Enable Reverse Connections</gui>.</p>
+<!-- TODO: add screenshot
+<figure>
+  <title>Reverse Connections dialog</title>
+  <media type="image" mime="image/png" src="figures/reverse-connections-dialog.png"/>
+</figure>-->
+</section>
+
+<section id="accessing-behind-firewall">
+  <title>Accessing a remote desktop behind a firewall</title>
+<p>The remote machine needs to connect to your machine using your IP address and
+port number, which are in the <gui>Reverse Connections...</gui> dialog, under
+<gui>Connectivity</gui>.</p>
+<note>
+<p>Currently, <app>Vino</app>, the GNOME VNC server, does not support reverse
+connections (also known as "listen mode"). Some other applications, such as
+<app>UltraVNC</app>, <app>RealVNC</app> and <app>TightVNC</app>, do have support
+for reverse connections.</p>
+</note>
+<p>Once a remote machine connects to your machine, <app>Vinagre</app> will
+establish the reverse connection.</p>
+<note>
+<p>When connecting to a machine which is not on your local network, you will
+will need to provide your externally visible IP address and port number to the
+remote server.</p>
+</note>
+</section>
+
+</page>
diff --git a/help/Makefile.am b/help/Makefile.am
index c8db6fa..415d0eb 100644
--- a/help/Makefile.am
+++ b/help/Makefile.am
@@ -11,9 +11,12 @@ DOC_FIGURES = \
 	figures/vinagre-editing-bookmarks.png	\
 	figures/vinagre-saving-bookmarks.png
 
+# TODO: Install reverse-connections only with the corresponding plugin.
+
 DOC_PAGES = \
 	bookmarks.page \
 	connect.page \
 	index.page \
 	preferences.page \
+	reverse-connections.page \
 	using.page