Automatic deploy (build number 512)

conan-io · Jul 6, 2023 · ba2f9d7 · ba2f9d7
1 parent 8ea6c57
commit ba2f9d7
Show file tree

Hide file tree

Showing 495 changed files with 571 additions and 487 deletions.
diff --git a/2.0/404.html b/2.0/404.html
@@ -214,7 +214,7 @@ <h1>Page Not Found<a class="headerlink" href="#page-not-found" title="Permalink
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/Page Not Found.html b/2.0/Page Not Found.html
@@ -209,7 +209,7 @@ <h1>Page not found</h1>
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/_sources/knowledge/guidelines.rst.txt b/2.0/_sources/knowledge/guidelines.rst.txt
@@ -39,7 +39,8 @@ Good practices
  solve conflicts are not recommended as a general versioning solution, just as a temporary workaround to solve 
  a version conflict. Its usage should be avoided whenever possible, and updating versions or version ranges in 
  the graph to avoid the conflicts without overrides and forces is the recommended approach.
-
+- **Please, do not abuse 'tool_requires'**. Those are intended only for executables like ``cmake`` and ``ninja`` running in the "build"
+ context, not for libraries or library-like dependencies, that must use ``requires`` or ``test_requires``.
 
 Forbidden practices
 -------------------

diff --git a/2.0/_sources/reference/conanfile/methods/build_requirements.rst.txt b/2.0/_sources/reference/conanfile/methods/build_requirements.rst.txt
@@ -27,6 +27,10 @@ The ``tool_requires`` is equivalent to ``requires()`` with the following traits:
 - ``headers=False`` A tool requirement does not have headers.
 - ``libs=False``: A tool requirement does not have libraries to be linked by the consumer (if it had libraries they would be in the "build" context and could be incompatible with the "host" context of the consumer package). 
 
+
+Recall that ``tool_requires`` are intended exclusively for depending on tools like ``cmake`` or ``ninja``, which run in the "build" context, but not for library-like dependencies that would be linked into binaries. For libraries or library-like dependencies, use ``requires`` or ``test_requires``.
+
+
 <host_version>
 **************
 

diff --git a/2.0/_sources/tutorial/consuming_packages/use_tools_as_conan_packages.rst.txt b/2.0/_sources/tutorial/consuming_packages/use_tools_as_conan_packages.rst.txt
@@ -204,6 +204,14 @@ the environment activation:
  ...
 
 
+.. note::
+
+ **Best practice**
+
+ ``tool_requires`` and tool packages are intended for executable applications, like ``cmake`` or ``ninja``. Do not
+ use ``tool_requires`` to depend on library or library-like dependencies.
+
+
 Read more
 ---------
 

diff --git a/...torial/creating_packages/other_types_of_packages/tool_requires_packages.rst.txt b/...torial/creating_packages/other_types_of_packages/tool_requires_packages.rst.txt
@@ -8,6 +8,17 @@ In the ":ref:`Using build tools as Conan packages <consuming_packages_tool_requi
 a tool require to build (or help building) our project or Conan package.
 In this section we are going to learn how to create a recipe for a tool require.
 
+.. note::
+
+ **Best practice**
+
+ ``tool_requires`` and tool packages are intended for executable applications, like ``cmake`` or ``ninja`` that
+ can be used as ``tool_requires("cmake/[>=3.25]")`` by other packages to put those executables in their path. They
+ are not intended for library-like dependencies (use ``requires`` for them), for test frameworks (use ``test_requires``)
+ or in general for anything that belongs to the "host" context of the final application. Do not abuse ``tool_requires``
+ for other purposes.
+
+
 Please, first clone the sources to recreate this project. You can find them in the
 `examples2.0 repository <https://github.com/conan-io/examples2>`_ on GitHub:
 

diff --git a/2.0/changelog.html b/2.0/changelog.html
@@ -594,7 +594,7 @@ <h2>2.0.0-beta1 (20-Jun-2022)<a class="headerlink" href="#beta1-20-jun-2022" tit
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/conan.pdf b/2.0/conan.pdf
diff --git a/2.0/examples.html b/2.0/examples.html
@@ -278,7 +278,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/commands.html b/2.0/examples/commands.html
@@ -248,7 +248,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/commands/pkglists.html b/2.0/examples/commands/pkglists.html
@@ -408,7 +408,7 @@ <h2>Removing packages lists<a class="headerlink" href="#removing-packages-lists"
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/conanfile.html b/2.0/examples/conanfile.html
@@ -254,7 +254,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/conanfile/layout.html b/2.0/examples/conanfile/layout.html
@@ -254,7 +254,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/conanfile/layout/conanfile_in_subfolder.html b/2.0/examples/conanfile/layout/conanfile_in_subfolder.html
@@ -323,7 +323,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/conanfile/layout/editable_components.html b/2.0/examples/conanfile/layout/editable_components.html
@@ -351,7 +351,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/conanfile/layout/multiple_subprojects.html b/2.0/examples/conanfile/layout/multiple_subprojects.html
@@ -350,7 +350,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/conanfile/layout/third_party_libraries.html b/2.0/examples/conanfile/layout/third_party_libraries.html
@@ -330,7 +330,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/conanfile/package_info.html b/2.0/examples/conanfile/package_info.html
@@ -250,7 +250,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/conanfile/package_info/components.html b/2.0/examples/conanfile/package_info/components.html
@@ -451,7 +451,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/conanfile/package_info/package_info_conf_and_env.html b/2.0/examples/conanfile/package_info/package_info_conf_and_env.html
@@ -247,7 +247,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/config_files.html b/2.0/examples/config_files.html
@@ -246,7 +246,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/config_files/settings/settings_user.html b/2.0/examples/config_files/settings/settings_user.html
@@ -473,7 +473,7 @@ <h2>Use your new settings<a class="headerlink" href="#use-your-new-settings" tit
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/cross_build.html b/2.0/examples/cross_build.html
@@ -244,7 +244,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/cross_build/android/android_studio.html b/2.0/examples/cross_build/android/android_studio.html
@@ -473,7 +473,7 @@ <h2>Building the application<a class="headerlink" href="#building-the-applicatio
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/cross_build/android/ndk.html b/2.0/examples/cross_build/android/ndk.html
@@ -299,7 +299,7 @@ <h2>Read more<a class="headerlink" href="#read-more" title="Permalink to this he
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/dev_flow.html b/2.0/examples/dev_flow.html
@@ -246,7 +246,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/dev_flow/debug/step_into_dependencies.html b/2.0/examples/dev_flow/debug/step_into_dependencies.html
@@ -305,7 +305,7 @@ <h2>Step into a dependency with Visual Studio<a class="headerlink" href="#step-i
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/extensions.html b/2.0/examples/extensions.html
@@ -255,7 +255,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/extensions/commands/clean/custom_command_clean_revisions.html b/2.0/examples/extensions/commands/clean/custom_command_clean_revisions.html
@@ -443,7 +443,7 @@ <h3>Conan public API<a class="headerlink" href="#conan-public-api" title="Permal
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/extensions/commands/custom_commands.html b/2.0/examples/extensions/commands/custom_commands.html
@@ -254,7 +254,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/extensions/deployers/builtin_deployers.html b/2.0/examples/extensions/deployers/builtin_deployers.html
@@ -249,7 +249,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/extensions/deployers/custom_deployers.html b/2.0/examples/extensions/deployers/custom_deployers.html
@@ -254,7 +254,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/extensions/deployers/dev/development_deploy.html b/2.0/examples/extensions/deployers/dev/development_deploy.html
@@ -363,7 +363,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/extensions/deployers/sources/custom_deployer_sources.html b/2.0/examples/extensions/deployers/sources/custom_deployer_sources.html
@@ -318,7 +318,7 @@ <h3>deploy()<a class="headerlink" href="#deploy" title="Permalink to this headli
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/graph.html b/2.0/examples/graph.html
@@ -250,7 +250,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/graph/requires/consume_cmake_macro.html b/2.0/examples/graph/requires/consume_cmake_macro.html
@@ -313,7 +313,7 @@ <h1>Use a CMake macro packaged in a dependency<a class="headerlink" href="#use-a
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/graph/tool_requires/different_options.html b/2.0/examples/graph/tool_requires/different_options.html
@@ -336,7 +336,7 @@ <h1>Depending on same version of a tool-require with different options<a class="
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/graph/tool_requires/different_versions.html b/2.0/examples/graph/tool_requires/different_versions.html
@@ -334,7 +334,7 @@ <h1>Depending on different versions of the same tool-require<a class="headerlink
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/graph/tool_requires/using_protobuf.html b/2.0/examples/graph/tool_requires/using_protobuf.html
@@ -458,7 +458,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/tools.html b/2.0/examples/tools.html
@@ -266,7 +266,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/tools/autotools/autotools.html b/2.0/examples/tools/autotools/autotools.html
@@ -254,7 +254,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/tools/autotools/autotools_toolchain/build_project_autotools_toolchain.html b/2.0/examples/tools/autotools/autotools_toolchain/build_project_autotools_toolchain.html
@@ -393,7 +393,7 @@ <h2>Building on Linux and macOS<a class="headerlink" href="#building-on-linux-an
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div> 

diff --git a/2.0/examples/tools/cmake/cmake.html b/2.0/examples/tools/cmake/cmake.html
@@ -257,7 +257,7 @@
  <div role="contentinfo">
  <p>
  &copy; Copyright 2016-2023, JFrog.
- Last updated on Jun 26, 2023.
+ Last updated on Jul 06, 2023.
  <span><a href="#" class="ot-sdk-show-settings">Cookies Settings</a></span>
  </p>
  </div>