diff --git a/docs/reference/run.md b/docs/reference/run.md
index 8e83d2b3..e14b1b1b 100644
--- a/docs/reference/run.md
+++ b/docs/reference/run.md
@@ -504,9 +504,10 @@ Or, to get the last time the container was (re)started;
     $ docker inspect -f "{{ .State.StartedAt }}" my-container
     # 2015-03-04T23:47:07.691840179Z
 
-You cannot set any restart policy in combination with
-["clean up (--rm)"](#clean-up-rm). Setting both `--restart` and `--rm`
-results in an error.
+
+Combining `--restart` (restart policy) with the `--rm` (clean up) flag results
+in an error. On container restart, attached clients are disconnected. See the
+examples on using the [`--rm` (clean up)](#clean-up-rm) flag later in this page.
 
 ### Examples