diff --git a/url/src/lib.rs b/url/src/lib.rs
index b17b82573..d498ee365 100644
--- a/url/src/lib.rs
+++ b/url/src/lib.rs
@@ -1524,7 +1524,8 @@ impl Url {
         }
     }
 
-    /// Change this URL’s query string.
+    /// Change this URL’s query string. If `query` is `None`, this URL's
+    /// query string will be cleared.
     ///
     /// # Examples
     ///