diff --git a/docs/reference/restart.md b/docs/reference/restart.md
index c371c1ac84..91a5a49b30 100644
--- a/docs/reference/restart.md
+++ b/docs/reference/restart.md
@@ -12,7 +12,8 @@ parent="smn_machine_subcmds"
 # restart
 
 Restart a machine. Oftentimes this is equivalent to
-`docker-machine stop; docker-machine start`.
+`docker-machine stop; docker-machine start`. But some cloud driver try to implement a clever restart which keeps the same
+ip address.
 
     $ docker-machine restart dev
     Waiting for VM to start...