ref-manual/classes.rst: ccache: mention that the host's ccache can be used

This feature was added by commit cc91a0f6500e ("ccache: enable ccache
for all recipes if it is in HOSTTOOLS") in OE-Core.

Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de>
(From yocto-docs rev: 47ded4e32c28420ddb47278b299093af649fab75)

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Antonin Godard 2025-10-27 13:43:36 +01:00 committed by Richard Purdie
parent 7eebd8b425
commit 1dd4a9ed98

View File

@ -392,8 +392,15 @@ file for details about how to enable this mechanism in your configuration
file, how to disable it for specific recipes, and how to share ``ccache``
files between builds.
However, using the class can lead to unexpected side-effects. Thus, using
this class is not recommended.
Recipes (including :ref:`ref-classes-native` ones) can make use of the host's
``ccache`` binary (via :term:`HOSTTOOLS`) if the following configuration
statements are provided in a :term:`configuration file`::
ASSUME_PROVIDED += "ccache-native"
HOSTTOOLS += "ccache"
Using the :ref:`ref-classes-ccache` class can lead to unexpected side-effects.
Using this class is not recommended.
.. _ref-classes-chrpath: