diff --git a/docs/Shorewall-5.xml b/docs/Shorewall-5.xml
index 901bf5baf..caa6b2161 100644
--- a/docs/Shorewall-5.xml
+++ b/docs/Shorewall-5.xml
@@ -362,5 +362,13 @@
 
     <para>These steps can also be taken after you upgrade, but your firewall
     likely won't start or work correctly until you do.</para>
+
+    <para>The <command>update</command> command in Shorewall 5 has many fewer
+    options. The <option>-b</option>, <option>-t</option>, <option>-n</option>
+    and <option>-s </option>options have been removed -- the updates triggered
+    by those options are now performed unconditionally. The <option>-i
+    </option>and <option>-A </option>options have been retained - both enable
+    checking for issues that could result if INLINE_MATCHES were to be set to
+    Yes.</para>
   </section>
 </article>