diff --git a/docs/upgrade_issues.xml b/docs/upgrade_issues.xml
index d6395062a..1ac14f021 100644
--- a/docs/upgrade_issues.xml
+++ b/docs/upgrade_issues.xml
@@ -227,7 +227,7 @@
- The Shorewall-core installer will automatically update
+ The Shorewall-core installer will automatically update
~/.shorewallrc and save the original in ~/.shorewallrc.bak.
@@ -239,6 +239,24 @@
SNMPTrap macro is added that opens port 162 (from SOURCE to
DEST).
+
+
+ Beginning with Shorewall 4.5.11, ?FORMAT is preferred over
+ FORMAT for specifying the format of records in these configuration
+ files:
+
+
+ action.* files
+
+ conntrack
+
+ interface
+
+ macro.* files
+
+ tcrules
+
+