diff --git a/reference/commands/run.rst b/reference/commands/run.rst index 44c94807809..f6e7d097e80 100644 --- a/reference/commands/run.rst +++ b/reference/commands/run.rst @@ -29,3 +29,24 @@ This command is useful when you want to execute some specific binary from any pa .. note:: This command activates both the ``host`` and ``build`` contexts, so that both contexts binaries are made available at once. In case that a package exists in both contexts, the ``host`` context binaries take precedence. + + +Running executables from profile ``[tool_requires]`` +---------------------------------------------------- + +.. include:: ../../common/experimental_warning.inc + +Starting in Conan 2.32, ``conan run`` can be invoked without a ``conanfile`` and without +``--requires`` / ``--tool-requires`` arguments. In that case, executables provided by the +``[tool_requires]`` section of the active profile can be executed directly: + +.. code-block:: text + :caption: *myprofile* + + include(default) + [tool_requires] + cmake/3.29.3 + +.. code-block:: bash + + $ conan run "cmake --version" -pr:h=myprofile