From dcca568584220ca05846d7b58b737f23e7fc1853 Mon Sep 17 00:00:00 2001
From: teastep <teastep@fbd18981-670d-0410-9b5c-8dc0c1a9a2bb>
Date: Tue, 9 Oct 2007 16:14:45 +0000
Subject: [PATCH] Update docs for removal of buildports.pl

git-svn-id: https://shorewall.svn.sourceforge.net/svnroot/shorewall/trunk@7437 fbd18981-670d-0410-9b5c-8dc0c1a9a2bb
---
 docs/Anatomy.xml                   | 3 ++-
 docs/configuration_file_basics.xml | 9 ++++++++-
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/docs/Anatomy.xml b/docs/Anatomy.xml
index e0cb6f664..f9dfd885d 100644
--- a/docs/Anatomy.xml
+++ b/docs/Anatomy.xml
@@ -329,7 +329,8 @@
     <itemizedlist>
       <listitem>
         <para><filename>buildports.pl</filename> - A Perl program that builds
-        the Shorewall/Ports.pm module during installation.</para>
+        the Shorewall/Ports.pm module during installation (This program is
+        removed in Shorewall 4.0.5 and later releases)</para>
       </listitem>
 
       <listitem>
diff --git a/docs/configuration_file_basics.xml b/docs/configuration_file_basics.xml
index 233d5f9be..7512462ee 100644
--- a/docs/configuration_file_basics.xml
+++ b/docs/configuration_file_basics.xml
@@ -628,7 +628,9 @@ Shorewall has detected the following iptables/netfilter capabilities:
     you can use either an integer or a service name from
     <filename>/etc/services</filename>.<note>
         <para>Shorewall-perl translates protocol names to protocol numbers and
-        service names to port numbers itself. The mapping that it uses is
+        service names to port numbers itself.</para>
+
+        <para>In Shorewall versions 4.0.0 - 4.0.4, the mapping that it uses is
         contained in the Perl module
         <filename>/usr/share/shorewall-perl/Shorewall/Ports.pm</filename>.
         That module is built when Shorewall is installed or upgraded using the
@@ -638,6 +640,11 @@ Shorewall has detected the following iptables/netfilter capabilities:
 
         <para>To generate a new Ports.pm module:<programlisting>cp /usr/share/shorewall-perl/Shorewall/Ports.pm /usr/share/shorewall-perl/Shorewall/Ports.pm.backup
 /usr/share/shorewall/buildports.pm &gt; /usr/share/shorewall-perl/Shorewall/Ports.pm</programlisting></para>
+
+        <para>Beginning with Shorewall version 4.0.5, the
+        <filename>/usr/share/shorewall-perl/Shorewall/Ports.pm</filename> has
+        been eliminated and the Shorewall-perl compiler uses Perl's interfaces
+        to getprotobyname(3posix) and getservbyname(3posix).</para>
       </note></para>
   </section>