diff --git a/site/proxy.md b/site/proxy.md
index ed54bd40..cb47673d 100644
--- a/site/proxy.md
+++ b/site/proxy.md
@@ -104,9 +104,13 @@ Multiple IP addresses and networks can be supplied in the `WEAVE_CIDR`
 variable by space-separating them, as in
 `WEAVE_CIDR="10.2.1.1/24 10.2.2.1/24"`.
 
-The docker IP will still be returned by `docker inspect`. If you want
-`docker inspect` to return the weave IP instead, then the proxy must
-be launced with the `--rewrite-inspect` flag.
+The docker NetworkSettings (including IP address, MacAddress, and
+IPPrefixLen), will still be returned by `docker inspect`. If you want
+`docker inspect` to return the weave NetworkSettings instead, then the
+proxy must be launced with the `--rewrite-inspect` flag. This will
+only substitute in the weave network settings when the container has a
+weave IP. If a container has more than one weave IP, the inspect call
+will only include one of them.
 
     host1$ weave launch-router && weave launch-proxy --rewrite-inspect