diff --git a/docs/MultiISP.xml b/docs/MultiISP.xml
index 3f3b86613..982d30a99 100644
--- a/docs/MultiISP.xml
+++ b/docs/MultiISP.xml
@@ -681,7 +681,23 @@
- /etc/shorewall/masq and Multi-ISP
+ What an entry in the Providers File Does Not Do
+
+ Shorewall itself provides no mechanism for dealing with provider
+ links that are in the up state but not responsive. If you want
+ transparent failover when a link is unresponsive, you must configure all
+ provider interfaces as optional (shorewall-interfaces(5))
+ then install and configure
+ LSM.
+
+ Shorewall-init provides
+ for handling links that go hard down and are later brought back
+ up.
+
+
+
+ ./etc/shorewall/masq and Multi-ISPIf you masquerade a local network, you will need to add masquerade
rules for both external interfaces. Referring to the diagram above, if