--build=compatible docstring (#17637)

* --build=compatible docstring * fix
conan-io · Jan 27, 2025 · 49332f8 · 49332f8
1 parent c1b4db5
commit 49332f8
Showing 1 changed file with 6 additions and 2 deletions.
diff --git a/conan/cli/args.py b/conan/cli/args.py
@@ -7,18 +7,22 @@
     '--build' options on one command line is allowed.
     Possible values:
 
-    --build="*"        Force build from source for all packages.
     --build=never      Disallow build for all packages, use binary packages or fail if a binary
                        package is not found, it cannot be combined with other '--build' options.
     --build=missing    Build packages from source whose binary package is not found.
     --build=cascade    Build packages from source that have at least one dependency being built from
                        source.
     --build=[pattern]  Build packages from source whose package reference matches the pattern. The
-                       pattern uses 'fnmatch' style wildcards.
+                       pattern uses 'fnmatch' style wildcards, so '--build="*"' will build everything
+                       from source.
     --build=~[pattern] Excluded packages, which will not be built from the source, whose package
                        reference matches the pattern. The pattern uses 'fnmatch' style wildcards.
     --build=missing:[pattern] Build from source if a compatible binary does not exist, only for
                               packages matching pattern.
+    --build=compatible:[pattern] (Experimental) Build from source if a compatible binary does not
+                                 exist, and the requested package is invalid, the closest package
+                                 binary following the defined compatibility policies (method and
+                                 compatibility.py)
 '''