[gnome-user-docs] Add two new pages on firewalls to include in security

[Shaun McCance <shaunm src gnome org>]

commit 36115be2d2cf6167d041f89756db6e3eb0aa4723
Author: Paul W. Frields <stickster gmail com>
Date:   Sun Mar 20 20:46:07 2011 -0400

    Add two new pages on firewalls to include in security

 gnome-help/C/net-firewall-on-off.page |   37 +++++++++++++++++++++++++
 gnome-help/C/net-firewall-ports.page  |   48 +++++++++++++++++++++++++++++++++
 2 files changed, 85 insertions(+), 0 deletions(-)
---
diff --git a/gnome-help/C/net-firewall-on-off.page b/gnome-help/C/net-firewall-on-off.page
new file mode 100644
index 0000000..ec3c8c4
--- /dev/null
+++ b/gnome-help/C/net-firewall-on-off.page
@@ -0,0 +1,37 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="net-firewall-on-off">
+
+  <info>
+    <link type="guide" xref="net#security"/>
+    <desc>You can control what programs are accessible by the network.</desc>
+    <revision pkgversion="3.0" version="0.1" date="2011-03-20" status="incomplete"/>
+    <credit type="author">
+      <name>Paul W. Frields</name>
+      <email>stickster gmail com</email>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+
+  <title>Enabling and blocking firewall access</title>
+  <p>Your system may be equipped with a firewall that allows it to block programs from being accessible by other network users.</p>
+  <p>Many GNOME programs are built to offer network services. For instance, you can share content, or let someone view your desktop remotely. Depending on how you installed GNOME, you may need to adjust the firewall to allow these services to work as intended. For instance, if your GNOME desktop was installed along with a larger software distribution, the firewall may also be pre-configured by the vendor.</p>
+  <p>Each program that provides services uses a specific <em>network port</em>. To enable access to that program's services, you may need to allow access to its assigned port on the firewall. To allow access, follow these steps.</p>
+
+  <steps>
+    <item>
+      <p>To locate your system's firewall tool, open the Overview, and type "firewall".</p>
+      <note>
+	<p>If this step doesn't locate the appropriate tool, consult the documentation for your overall operating system for the correct application name. To open the application, hit <keyseq type="combo"><key>Alt</key><key>F2</key></keyseq>, type that name, and hit <key>Enter</key>.</p>
+      </note>
+    </item>
+    <item>
+      <p>To allow access to the desired port number through the firewall, enable the port. To block access, disable the port. Repeat this step as needed.</p>
+    </item>
+    <item>
+      <p>Save or apply the changes, following any additional instructions given by the firewall tool.</p>
+    </item>
+  </steps>
+
+</page>
diff --git a/gnome-help/C/net-firewall-ports.page b/gnome-help/C/net-firewall-ports.page
new file mode 100644
index 0000000..9ea15b5
--- /dev/null
+++ b/gnome-help/C/net-firewall-ports.page
@@ -0,0 +1,48 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="net-firewall-ports">
+
+  <info>
+    <link type="guide" xref="net#security"/>
+    <desc>Look at a list of programs that can be allowed through your system's firewall.</desc>
+    <revision pkgversion="3.0" version="0.1" date="2011-03-20" status="incomplete"/>
+    <credit type="author">
+      <name>Paul W. Frields</name>
+      <email>stickster gmail com</email>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+
+  <title>Firewall port list</title>
+  <p>The following table lists ports used by your system's firewall to <link xref="net-firewall-on-off">block or allow access</link> to GNOME programs over the network. There are thousands of ports in use, so this table isn't complete. Instead, it presents some of the most common ports you may want to configure on your system. In some cases, the vendor of your GNOME desktop may have pre-configured access to these ports when the system was installed.</p>
+
+  <table>
+    <thead>
+      <tr>
+	<td>
+	  <p>Port</p>
+	</td>
+	<td>
+	  <p>Name</p>
+	</td>
+	<td>
+	  <p>Description</p>
+	</td>
+      </tr>
+    </thead>
+    <tbody>
+      <tr>
+	<td>
+	  <p>5353/udp</p>
+	</td>
+	<td>
+	  <p>mDNS/Avahi</p>
+	</td>
+	<td>
+	  <p>Allows systems to find each other, and describe their service offerings, without the user having to configure it</p>
+	</td>
+      </tr>
+    </tbody>
+  </table>
+</page>