diff --git a/docs/FAQ.xml b/docs/FAQ.xml
index 184d922a7..7516aaec9 100644
--- a/docs/FAQ.xml
+++ b/docs/FAQ.xml
@@ -129,23 +129,62 @@
shorewall-core package was added and all of the
other packages depend on shorewall-core.
+
+
+ (FAQ 1.5) After installing the latest version (> 5.1.10.1) of
+ Shorewall, when I change my configuration and 'shorewall reload' or
+ 'shorewall restart', my changes aren't in the running ruleset. Why is
+ that happening?
+
+ Answer: This happens when:
+
+
+
+ You use INCLUDE (?INCLUDE).
+
+
+
+ The included files are in a subdirectory of /etc/shorewall[6]
+ or in a separate directory.
+
+
+
+ You have AUTOMAKE=Yes in shorewall[6].conf(5).
+
+
+
+ When AUTOMAKE=Yes, the compiler looks for files in each directory
+ in CONFIG_PATH for files that are newer that the last-generated firewall
+ script. If none are found, the old script is used as is. Prior to
+ version 5.1.10.2, that search was recursive so changes in
+ sub-directories of /etc/shorewall[6] were automatically searched. This
+ had performance implications if directories on the CONFIG_PATH were
+ deeply nested. So, beginning with version 5.1.10.2, only the directories
+ themselves are searched. You can restore the pre-5.1.10.2 behavior by
+ setting AUTOMAKE=recursive, or
+ AUTOMAKE=integer, where integer specifies the
+ search depth. If your included files are in a separate directory, then
+ that directory must be added to CONFIG_PATH in order to allow AUTOMAKE
+ to work correctly.
+ Upgrading Shorewall
- (FAQ 66) I'm trying to upgrade to Shorewall 4.x; which of these
- packages do I need to install?
+ (FAQ 66) I'm trying to upgrade to Shorewall 4.x or later; which
+ of these packages do I need to install?Answer: Please see the upgrade issues.
- (FAQ 34) I am trying to upgrade to Shorewall 4.4 and I can't find
- the shorewall-common, shorewall-shell and shorewall-perl packages? Where
- are they?
+ (FAQ 34) I am trying to upgrade to Shorewall 4.4 or later and I
+ can't find the shorewall-common, shorewall-shell and shorewall-perl
+ packages? Where are they?Answer:In Shorewall 4.4, the
shorewall-shell package was discontinued. The
@@ -193,6 +232,16 @@
command that does a smart merge of your existing shorewall.conf and the
new one.
+
+
+ (FAQ 2 .6) After upgrading to the latest version (> 5.1.10.1)
+ of Shorewall, when I change my configuration and 'shorewall reload' or
+ 'shorewall restart', my changes aren't in the running ruleset. Why is
+ that happening?
+
+ Answer: See FAQ 1.5.
+