From 68abb4851764b57094e080a2ac81b62b2c5efbef Mon Sep 17 00:00:00 2001
From: teastep <teastep@fbd18981-670d-0410-9b5c-8dc0c1a9a2bb>
Date: Sat, 20 Jan 2007 23:01:05 +0000
Subject: [PATCH] Add 'Getting Started' article to SVN

git-svn-id: https://shorewall.svn.sourceforge.net/svnroot/shorewall/trunk@5272 fbd18981-670d-0410-9b5c-8dc0c1a9a2bb
---
 docs/GettingStarted.xml | 140 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 140 insertions(+)
 create mode 100644 docs/GettingStarted.xml

diff --git a/docs/GettingStarted.xml b/docs/GettingStarted.xml
new file mode 100644
index 000000000..b3fece132
--- /dev/null
+++ b/docs/GettingStarted.xml
@@ -0,0 +1,140 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
+<article>
+  <!--$Id$-->
+
+  <articleinfo>
+    <title>Getting Started with Shorewall</title>
+
+    <authorgroup>
+      <author>
+        <firstname>Tom</firstname>
+
+        <surname>Eastep</surname>
+      </author>
+    </authorgroup>
+
+    <pubdate><?dbtimestamp format="Y/m/d"?></pubdate>
+
+    <copyright>
+      <year>2006</year>
+
+      <holder>Thomas M. Eastep</holder>
+    </copyright>
+
+    <legalnotice>
+      <para>Permission is granted to copy, distribute and/or modify this
+      document under the terms of the GNU Free Documentation License, Version
+      1.2 or any later version published by the Free Software Foundation; with
+      no Invariant Sections, with no Front-Cover, and with no Back-Cover
+      Texts. A copy of the license is included in the section entitled
+      <quote><ulink url="GnuCopyright.htm">GNU Free Documentation
+      License</ulink></quote>.</para>
+    </legalnotice>
+  </articleinfo>
+
+  <section>
+    <title>Getting Started</title>
+
+    <para>If you are new to Shorewall, please read these two articles
+    first.</para>
+
+    <itemizedlist>
+      <listitem>
+        <para><ulink url="Introduction.html">Introduction to
+        Shorewall</ulink></para>
+      </listitem>
+
+      <listitem>
+        <para><ulink url="shorewall_quickstart_guide.htm">QuickStart Guides
+        (HOWTOs)</ulink></para>
+      </listitem>
+    </itemizedlist>
+
+    <para>The following article is also recommended reading for
+    newcomers.</para>
+
+    <itemizedlist>
+      <listitem>
+        <para><ulink url="configuration_file_basics.htm">Configuration File
+        Basics</ulink><blockquote>
+            <para><informaltable frame="none">
+                <tgroup cols="2">
+                  <tbody valign="middle">
+                    <row>
+                      <entry><ulink
+                      url="Documentation_Index.html#Manpages">Man
+                      Pages</ulink></entry>
+
+                      <entry><ulink
+                      url="configuration_file_basics.htm#MAC">Using MAC
+                      Addresses in Shorewall</ulink></entry>
+                    </row>
+
+                    <row>
+                      <entry><ulink
+                      url="configuration_file_basics.htm#Comments">Comments in
+                      configuration files</ulink></entry>
+
+                      <entry><ulink
+                      url="configuration_file_basics.htm#Variables">Using
+                      Shell Variables</ulink></entry>
+                    </row>
+
+                    <row>
+                      <entry><ulink
+                      url="configuration_file_basics.htm#COMMENT">Attach
+                      Comment to Netfilter Rules</ulink></entry>
+
+                      <entry><ulink
+                      url="configuration_file_basics.htm#dnsnames">Using DNS
+                      Names</ulink></entry>
+                    </row>
+
+                    <row>
+                      <entry><ulink
+                      url="configuration_file_basics.htm#Continuation">Line
+                      Continuation</ulink></entry>
+
+                      <entry><ulink
+                      url="configuration_file_basics.htm#Compliment">Complementing
+                      an IP address or Subnet</ulink></entry>
+                    </row>
+
+                    <row>
+                      <entry><ulink
+                      url="configuration_file_basics.htm#INCLUDE">INCLUDE
+                      Directive</ulink></entry>
+
+                      <entry><ulink
+                      url="configuration_file_basics.htm#IPRanges">IP Address
+                      Ranges</ulink></entry>
+                    </row>
+
+                    <row>
+                      <entry><ulink
+                      url="configuration_file_basics.htm#Ports">Port
+                      Numbers/Service Names</ulink></entry>
+
+                      <entry><ulink
+                      url="configuration_file_basics.htm#Levels">Shorewall
+                      Configurations (making a test
+                      configuration)</ulink></entry>
+                    </row>
+
+                    <row>
+                      <entry><ulink
+                      url="configuration_file_basics.htm#Ranges">Port
+                      Ranges</ulink></entry>
+
+                      <entry></entry>
+                    </row>
+                  </tbody>
+                </tgroup>
+              </informaltable></para>
+          </blockquote></para>
+      </listitem>
+    </itemizedlist>
+  </section>
+</article>
\ No newline at end of file