doc: Clarify verbosity when using pip (#513)

This clarifies that you have to also use `-v` to get the logging information set in the options. I am not sure if you also need the additional `-vv` settings depending on `logging.level`. Thoughts? Signed-off-by: Cristian Le <[email protected]>
scikit-build · Sep 27, 2023 · ea68dff · ea68dff
1 parent 47194df
commit ea68dff
Showing 1 changed file with 8 additions and 1 deletion.
diff --git a/docs/configuration.md b/docs/configuration.md
@@ -28,7 +28,7 @@ logging.level = "INFO"
 ````{tab} pip
 
 ```console
-$ pip install . --config-settings=cmake.verbose=true --config-settings=logging.level=INFO
+$ pip install . -v --config-settings=cmake.verbose=true --config-settings=logging.level=INFO
 ```
 
 ````
@@ -64,6 +64,13 @@ SKBUILD_LOGGING_LEVEL: "INFO"
 
 ````
 
+:::{note}
+
+When using `pip`, make sure you include at least a `-v` argument so that the
+verbosity settings above are displayed.
+
+:::
+
 :::{warning}
 
 In general, the environment variable method is intended as an emergency