Improve documentation (#10477)

Co-authored-by: Houssem ZITOUN <houssem.zitoun@ekino.com>

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