From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id D489CCAC5B8 for ; Mon, 6 Oct 2025 16:15:01 +0000 (UTC) Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) by mx.groups.io with SMTP id smtpd.web11.379.1759767296187856586 for ; Mon, 06 Oct 2025 09:14:57 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=L2hnJg5m; spf=pass (domain: bootlin.com, ip: 185.246.85.4, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-03.galae.net (Postfix) with ESMTPS id 27ACC4E40EED for ; Mon, 6 Oct 2025 16:14:54 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id DA13C606B7; Mon, 6 Oct 2025 16:14:53 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 6E4E9102F1E99; Mon, 6 Oct 2025 18:14:50 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1759767293; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=UMFoKDQvP6QHZKpEf1eg8JUwTq/uxozKhACAij+wgi8=; b=L2hnJg5mjK3rdjVshiTCYaIXCPWqNQvP65xwpIxlcG5tj5eJt9HsE6oneRcPFu7XE2lC8t MIPgFs1D1dSK0VIFi01jZNKLfrrcEWNMtZUBPMTcAuoU+UutGn0dCsJrNx/K76m23nEmVm lMMRCI52dqiqq8iKdn/v4QCDeh8FR/HujMYOVOi317DRlGs4suZ+Ls92TV30oHCybEKUmL LURF150iVFAOgAuIxtNaLf3zRD6Jq9JS3JNmRmpdqVep22lX15A59+kJPeH5otJUpnVq6W k/vy6KjFv9k1jszJxRwsDCtnpIkrOLrTNrhvpTn+mE2fNA+rdb1Enbm9V1X7lw== Mime-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=UTF-8 Date: Mon, 06 Oct 2025 18:14:49 +0200 Message-Id: To: , Subject: Re: [docs] [PATCH] ref-manual: correctly document the difference between auto.conf and newly added toolcfg.conf Cc: "Alexander Kanavin" From: "Antonin Godard" References: <20251006134757.36206-1-alex@linutronix.de> In-Reply-To: <20251006134757.36206-1-alex@linutronix.de> X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from li982-79.members.linode.com [45.33.32.79] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Mon, 06 Oct 2025 16:15:01 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/7659 On Mon Oct 6, 2025 at 3:47 PM CEST, Alexander Kanavin via lists.yoctoprojec= t.org wrote: > Signed-off-by: Alexander Kanavin > --- > documentation/ref-manual/fragments.rst | 4 ++-- > documentation/ref-manual/structure.rst | 15 ++++++++++++--- > 2 files changed, 14 insertions(+), 5 deletions(-) > > diff --git a/documentation/ref-manual/fragments.rst b/documentation/ref-m= anual/fragments.rst > index c0118876c..7fd08656d 100644 > --- a/documentation/ref-manual/fragments.rst > +++ b/documentation/ref-manual/fragments.rst > @@ -94,7 +94,7 @@ Note that in this case, the fragment will be defined tw= ice in > :term:`OE_FRAGMENTS`, and the last value is taken into account: > =20 > .. code-block:: > - :caption: build/conf/auto.conf > + :caption: build/conf/toolcfg.conf > =20 > OE_FRAGMENTS +=3D " ... machine/qemuarm64 machine/qemux86-64" > =20 > @@ -103,7 +103,7 @@ In the above example, the value of :term:`MACHINE` is= thus equal to > =20 > When a fragment is enabled with :ref:`ref-bitbake-config-build-enable-fr= agment`, > its name is automatically appended to the :term:`OE_FRAGMENTS` variable = in > -:ref:`structure-build-conf-auto.conf`. > +:ref:`structure-build-conf-toolcfg.conf`. > =20 > .. note:: > =20 > diff --git a/documentation/ref-manual/structure.rst b/documentation/ref-m= anual/structure.rst > index 1aaafcf79..0ef51fa4f 100644 > --- a/documentation/ref-manual/structure.rst > +++ b/documentation/ref-manual/structure.rst > @@ -356,15 +356,24 @@ This configuration file is generated by :doc:`bbloc= k ` and > contains the signatures locked by ``bblock``. By default, it does not ex= ist > and will be created upon the first invocation of ``bblock``. > =20 > -.. _structure-build-conf-auto.conf: > +.. _structure-build-conf-toolcfg.conf: > =20 > -``build/conf/auto.conf`` > ------------------------- > +``build/conf/toolcfg.conf`` > +--------------------------- > =20 > This file contains configuration variables that are automatically modifi= ed by > tools such as :oe_git:`bitbake-config-build `. > This file should not be modified manually. > =20 > +.. _structure-build-conf-auto.conf: > + > +``build/conf/auto.conf`` > +------------------------ > + > +This file is intended for use by continuous integration environments, su= ch as the > +Yocto Project's autobuilder. It should not be created or modified when r= unning > +local builds. > + > .. _structure-build-downloads: > =20 > ``build/downloads/`` We also need to update the auto.conf reference in the fragments documentati= on. Do you want to send a patch? But otherwise this change looks good to me, thank you! Antonin --=20 Antonin Godard, Bootlin Embedded Linux and Kernel engineering https://bootlin.com