Merge pull request #2023 from uilianries/feature/skip-build-package

Add --build=!skip for install command

Author: czoido

mastering/policies.rst

@@ -13,6 +13,7 @@ As previously demonstrated, we can use the :command:`--build` option to change t
 - :command:`--build cascade` will build from code all the nodes with some dependency being built (for any reason). Can be used together with any
   other build policy. Useful to make sure that any new change introduced in a dependency is incorporated by building again the package.
 - :command:`--build pattern*` will build only the packages with the reference starting with "pattern".
+- :command:`--build --build=!some_package` will build all requirements from sources, except for some_package.
 
 
 With the ``build_policy`` attribute in the `conanfile.py` the package creator can change the default Conan's build behavior. The allowed build_policy values are:

reference/commands/consumer/install.rst

@@ -81,10 +81,13 @@ generators.
                             built from source. --build=[pattern] Build packages
                             from source whose package reference matches the
                             pattern. The pattern uses 'fnmatch' style wildcards.
-                            Default behavior: If you omit the '--build' option,
-                            the 'build_policy' attribute in conanfile.py will be
-                            used if it exists, otherwise the behavior is like '--
-                            build=never'.
+                            --build=![pattern] Excluded packages, which will not
+                            be built from the source, whose package reference
+                            matches the pattern. The pattern uses 'fnmatch' style
+                            wildcards. Default behavior: If you omit the '--build'
+                            option, the 'build_policy' attribute in conanfile.py
+                            will be used if it exists, otherwise the behavior is
+                            like '--build=never'.
       -r REMOTE, --remote REMOTE
                             Look in the specified remote server
       -u, --update          Will check the remote and in case a newer version
@@ -244,6 +247,13 @@ Possible values are:
    - e.g., :command:`--build=zlib` will match any package named ``zlib`` (same as ``zlib/*``).
    - e.g., :command:`--build=z*@conan/stable` will match any package starting with ``z`` with ``conan/stable`` as user/channel.
 
+* :command:`--build=![pattern]`: A fnmatch case-sensitive pattern of a package reference or only the package name.
+  Conan will exclude the build of the packages whose reference matches the given
+  **pattern**. Several patterns can be specified, chaining multiple options:
+
+   - e.g., :command:`--build=!zlib --build` Build all packages from source, except for zlib.
+   - e.g., :command:`--build=!z* --build` Build all packages from source, except for those starting with ``z``
+
 If you omit the :command:`--build` option, the ``build_policy`` attribute in `conanfile.py` will be
 looked up. If it is set to ``missing`` or ``always``, this build option will be used, otherwise the
 command will behave like :command:`--build=never` was set.

reference/commands/creator/create.rst

@@ -87,10 +87,13 @@ to know more about 'test_folder' project.
                             built from source. --build=[pattern] Build packages
                             from source whose package reference matches the
                             pattern. The pattern uses 'fnmatch' style wildcards.
-                            Default behavior: If you omit the '--build' option,
-                            the 'build_policy' attribute in conanfile.py will be
-                            used if it exists, otherwise the behavior is like '--
-                            build=package name'.
+                            --build=![pattern] Excluded packages, which will not
+                            be built from the source, whose package reference
+                            matches the pattern. The pattern uses 'fnmatch' style
+                            wildcards. Default behavior: If you omit the '--build'
+                            option, the 'build_policy' attribute in conanfile.py
+                            will be used if it exists, otherwise the behavior is
+                            like '--build=package name'.
       -r REMOTE, --remote REMOTE
                             Look in the specified remote server
       -u, --update          Will check the remote and in case a newer version

reference/commands/creator/test.rst

@@ -54,10 +54,13 @@ to be tested must exist in the local cache or any configured remote.
                             built from source. --build=[pattern] Build packages
                             from source whose package reference matches the
                             pattern. The pattern uses 'fnmatch' style wildcards.
-                            Default behavior: If you omit the '--build' option,
-                            the 'build_policy' attribute in conanfile.py will be
-                            used if it exists, otherwise the behavior is like '--
-                            build=never'.
+                            --build=![pattern] Excluded packages, which will not
+                            be built from the source, whose package reference
+                            matches the pattern. The pattern uses 'fnmatch' style
+                            wildcards. Default behavior: If you omit the '--build'
+                            option, the 'build_policy' attribute in conanfile.py
+                            will be used if it exists, otherwise the behavior is
+                            like '--build=never'.
       -r REMOTE, --remote REMOTE
                             Look in the specified remote server
       -u, --update          Will check the remote and in case a newer version