diff --git a/doc/03-cli.md b/doc/03-cli.md
index 1d262dfd7..e5089f45f 100644
--- a/doc/03-cli.md
+++ b/doc/03-cli.md
@@ -156,17 +156,17 @@ composer.json you can use `--with` and provide a custom version constraint:
 php composer.phar update --with vendor/package:2.0.1
 ```
 
-The custom constraint has to be a subset of the existing constraint you have,
-and this feature is only available for your root package dependencies.
-
-If you only want to update the package(s) for which you provide custom constraints
-using `--with`, you can skip `--with` and just use constraints with the partial
-update syntax:
+Note that with the above all packages will be updated. If you only want to
+update the package(s) for which you provide custom constraints using `--with`,
+you can skip `--with` and instead use constraints with the partial update syntax:
 
 ```sh
 php composer.phar update vendor/package:2.0.1 vendor/package2:3.0.*
 ```
 
+The custom constraint has to be a subset of the existing constraint you have,
+and this feature is only available for your root package dependencies.
+
 
 ### Options