From patchwork Fri Nov 14 11:12:34 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 74541 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 432E5CE7AE9 for ; Fri, 14 Nov 2025 11:12:59 +0000 (UTC) Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.15652.1763118770366871581 for ; Fri, 14 Nov 2025 03:12:50 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=WFpOXw4L; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id E8C9FC10F66 for ; Fri, 14 Nov 2025 11:12:25 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id A818260719; Fri, 14 Nov 2025 11:12:47 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id B6F1E1037125A; Fri, 14 Nov 2025 12:12:44 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1763118765; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=vt+BOaH1O2gyerUfv4OqVmFACgQCMEhkP7nr0SG5QW0=; b=WFpOXw4LXdi+VkJjQum0977Cy3ysx5lamSJXqHpwMOkQnCcyQbT1n9x0YTwcUJoDJpATy0 q8x60iZy8OIDHMtoUNnBkWIZ1WSi+V7h7tSA5isXFRjN5E6dcXgummT9dtRhUhGZL0GQjx n4yCh0ODZhw2/1PTiXE2ifV7tIgtMf8D0KOtkK0KPIII/ORPyevSOFYzunsEoyTAvxyBr8 PTb+fehqqxUW07VxLkNnxJuWPhpSJzX+2+yV4wdBwC0uc/CtUoV1gr5ftH21m+m27GnDPF RhS8HIGMaKdraN7XfEihiGLH+zSD7VAYMdt157afPN7Zl4SMqq1+PFFcFHp+6g== From: Antonin Godard Date: Fri, 14 Nov 2025 12:12:34 +0100 Subject: [PATCH 1/3] doc/bitbake-setup: show how to clone bitbake before using bitbake-setup MIME-Version: 1.0 Message-Id: <20251114-update-bbsetup-doc-v1-1-044070bdffec@bootlin.com> References: <20251114-update-bbsetup-doc-v1-0-044070bdffec@bootlin.com> In-Reply-To: <20251114-update-bbsetup-doc-v1-0-044070bdffec@bootlin.com> To: bitbake-devel@lists.openembedded.org Cc: Thomas Petazzoni , docs@lists.yoctoproject.org, Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1789; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=CjcRYyjdqrhysg1WA4TcpwNQeEaoT6kf6i4D92pxORk=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpFw6qyZiZYL3xK0iBm6DqwWl1TicuhNYpQYWfu BSbvzPHlQ6JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaRcOqgAKCRDRgEFAKaOo Np0cD/0fxpJshSnBlOpSW/MxvOrxCAGSKwH8bpzZXFR73IO1OF8RkVJAs68P+V4XyDhC0hkoF4V px+UeMWtdsYrGSEHCAIa/afvznRdGQKaCRgXkGJxBnc13W1jbjryELRxVEOYy0cRn7zdOJ2G4T+ frRBD61eJZA4l7i0ttUhwiVC43BN55MpNKLQTr7wXfcSfe6cwTXnbY+f/IFF6nHg+Qw3o/z+rRv 9uTgn2ScsLgiThR/884Ys5l+i0Rm+UK3U5UQ3PIPcrz5I4lQs/FkHbzJlJoLxqt9cIFHjFAXV6m 471/u824jZNiRccgr7xdUrjvd76FgdUa9GmoigEgK20oeqMQ5QnC/dlRRxu5CAdGDVy8EIgQ9kk 9bdwTSK9s2tVv5bi9SWYOFuWA85xwrb/ZJsk8NtUgIP5zVdQH5hcAzrSlczvoP61sveMeRMwDCg T8XbW6ZMAPRZeZ0Cg/XAhN+FrCpnogiSjWw4WTJC59ThuOqk+grP+qyrwkbmxMCDVXrLo+AcMOU +oWY+VI3sTWNQ9I1XKOEVihGWYkehwsze4fMWnlM3Z/i+2fTWXqQIZ0JC3zTkBsxnS0MP2HWIsW QwC1CgjSgtog7iNwjamAddE1ubHV7v3ayqXLsrCo7MpnZyd8K1g3GlM9rKOeDX/UUP1w3TDiv7W t/eqSpTjYyCLRZA== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Fri, 14 Nov 2025 11:12:59 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8040 Users reading the documentation on the website or else might not have a copy of bitbake yet. It is not straightforward to users that bitbake-setup is part of the source tree and that it is the only location to use it from (for now). Add a step at the beginning of the Quick Start section that shows how to clone bitbake-setup. The default branch (master) will be cloned, which is currently what is recommended. This might be subject to change in the future if bitbake-setup becomes backwards-incompatible. Signed-off-by: Antonin Godard --- .../bitbake-user-manual-environment-setup.rst | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst b/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst index 66c0b0fa68..9ae8ca7fb9 100644 --- a/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst +++ b/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst @@ -25,12 +25,20 @@ the following tasks: Quick Start =========== -#. ``bitbake-setup`` is part of the BitBake repository under - ``./bin/bitbake-setup``. To start, run: +#. If you haven't already, clone the BitBake repository: .. code-block:: shell - $ ./bin/bitbake-setup init + $ git clone https://git.openembedded.org/bitbake + +#. ``bitbake-setup`` is part of the BitBake source tree under + ``./bitbake/bin/bitbake-setup``. + + To start, run: + + .. code-block:: shell + + $ ./bitbake/bin/bitbake-setup init This command will ask you to choose which configurations to use available as part of the default BitBake :term:`generic configurations X-Patchwork-Id: 74540 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 236DBCE7AE4 for ; Fri, 14 Nov 2025 11:12:59 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.15549.1763118769322581910 for ; Fri, 14 Nov 2025 03:12:49 -0800 Authentication-Results: mx.groups.io; dkim=fail reason="dkim: body hash did not verify" header.i=@bootlin.com header.s=dkim header.b=ywIYUv1Q; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 07C0F1A1AA3 for ; Fri, 14 Nov 2025 11:12:48 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id BBA5760724; Fri, 14 Nov 2025 11:12:47 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 75CCC103713C2; Fri, 14 Nov 2025 12:12:45 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1763118766; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=I9PeT6MjFTtnPD4lgP/GgnCBz6JGEw0jG9SvhbJH5Xg=; b=ywIYUv1Qxqh9DhQDDr192613LeYxiILPE3Rz3V3iXSHltDO4rnZpZTAqYxlhbm/uzvCmr1 hRZwalKODba5Gl+Dq8iSGtvckIPvZrjaEnpbHbBvSgoEIKW0s1D3xqnprHrK0gMk5xCCw3 gzy7eujc1WAo2x6RIj2Bn+RRPunnxV2JnabJD1StWyvnonTMMM5bKQugChjo4wlbncbdSd yG+v/yFBE8bps8DHQv/6WJcswEkv4CIA7WSI/2xEPoa2N5ebZU6Kv1C69slCuGMztsJtPh yUaNeE7aEY7zDUXpvCZ6wYbi4tQBqxScqU6WE/GDzFCcPVVYTF5Fi5dBzkg64Q== From: Antonin Godard Date: Fri, 14 Nov 2025 12:12:35 +0100 Subject: [PATCH 2/3] doc/bitbake-setup: quick start: change top dir path MIME-Version: 1.0 Message-Id: <20251114-update-bbsetup-doc-v1-2-044070bdffec@bootlin.com> References: <20251114-update-bbsetup-doc-v1-0-044070bdffec@bootlin.com> In-Reply-To: <20251114-update-bbsetup-doc-v1-0-044070bdffec@bootlin.com> To: bitbake-devel@lists.openembedded.org Cc: Thomas Petazzoni , docs@lists.yoctoproject.org, Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1340; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=0qN3awy8Jh6TzIUAMF7DKxnANChk7IxxrcYxJfeRXFk=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpFw6qLoILvk2cPfL3aCgmy+/vu56egudrmfACx HJ4uZdz0dOJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaRcOqgAKCRDRgEFAKaOo NqfoEADJJA7ym9fNgD08VMyeYF0hhywL05hhr8r6Y+m7biXjdoAiO7jnO5XwPhErVw4FTWq8NbA Dmr56/qQIVmCJE6RtIhR5Kjwlqrws0AkZVxi54us5/HTS0c66+Yit4tBLrQUUqCCOU4UG3TOPun mcDo6ByaHQ9tqmpoNMYsIPnkoCN9I3u1Sbwb5BIz/ajz+q/rfXLOeBsdpTnEWhMX8BKoBHlc3nT cc70fPHOhzUAuTIDkTek7PPG7l6rVEh4PPS5W85rPk97aREdGWj0Eyv7+I/jTAmEI6jSf5dWOb6 Nv8ezpRLWFIfRwYcp+t0IN6qP5vgTuS2mEA3gGI6w3PClfrQ684sIGF0UV47HZ1OpLL/7TkIEe2 ITJZ4vpBXbrSV8vpekKSZ001BEQlhG0hX2s+eM1L2BhkcbYEDIxIGxqMhHmM12ZkkIWjVKRd4PD FmbyCaXOYKkvlUp2RomBmgX1kDwjaj542+kRPwoG3/IsVwCVU9qv/oZ5JUX0QKSPFSDtsII5W51 q65jChp2BHxaqwEqqS+8xCWmOc0np0kUNIXDTksBp7LDqr45ZbQiG4o0qVKfq8Tf1wUEuohWWI/ SJa7tOxsJNvfGyR20p7VcPIJSQ8deXyA8Cmd2qmjTG6e1W/3CFaTz09RlBqZllN5dzjeAjkrHRp XPWesH25ruRJOQQ== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Fri, 14 Nov 2025 11:12:59 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8039 The top-directory is now created in the CWD, so replace ~ by . in the example. Signed-off-by: Antonin Godard --- doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst b/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst index 9ae8ca7fb9..91caeb041d 100644 --- a/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst +++ b/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst @@ -53,7 +53,7 @@ Quick Start #. With the default choices, the ``bitbake-setup init`` command creates the following directories:: - ~/bitbake-builds/ + ./bitbake-builds/ └── poky-master-poky-distro_poky-machine_qemux86-64/    ├── build/    ├── config/ @@ -61,7 +61,7 @@ Quick Start With: - - ``~/bitbake-build``: the :term:`Top Directory`, where ``bitbake-setup`` + - ``./bitbake-builds``: the :term:`Top Directory`, where ``bitbake-setup`` configures everything. This directory can be configured with the :ref:`ref-bbsetup-setting-top-dir-prefix` and :ref:`ref-bbsetup-setting-top-dir-name` settings. From patchwork Fri Nov 14 11:12:36 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 74539 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 165AACE7AB9 for ; Fri, 14 Nov 2025 11:12:59 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.15649.1763118769271062117 for ; Fri, 14 Nov 2025 03:12:49 -0800 Authentication-Results: mx.groups.io; dkim=fail reason="dkim: body hash did not verify" header.i=@bootlin.com header.s=dkim header.b=M4+25CLD; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id E9A241A1AA2 for ; Fri, 14 Nov 2025 11:12:47 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id B8EA660723; Fri, 14 Nov 2025 11:12:47 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 6008910371C51; Fri, 14 Nov 2025 12:12:46 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1763118766; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=ROiormWOmzlU78JoRAPuRB065Mh/aY6aTXtaj//E0zs=; b=M4+25CLDMPZGOyp+bAlc9B415lF3d7uJY8ZECgkxIHO2AAAXliEE/xsfhg1xX/d5auTylH JS0qpnHQAPIIHxfynFsqBlKarQskreHD9YH7YpsWZE2wpB4UpavLic2Ucdetuvals9OAQP g6a8dVp+HIbA7ibD8rszW94E00MUTA+1nFDsanvLuy+QBpvUUwq2hVbqh8hT7mn/bUpWhN /rFdd1SqEEx3vt+jYxH12IO++jM2v9wDxUtotesksY4+9LluizxY0S912uigOFjw2vhBvT q8IclWpNYdJfUBuzVaoQ3H/DDENy/lhx4TCfl6jr7+Q7fnR4QV5MZ8vctvGCtg== From: Antonin Godard Date: Fri, 14 Nov 2025 12:12:36 +0100 Subject: [PATCH 3/3] doc/bitbake-setup: mention the site.conf file MIME-Version: 1.0 Message-Id: <20251114-update-bbsetup-doc-v1-3-044070bdffec@bootlin.com> References: <20251114-update-bbsetup-doc-v1-0-044070bdffec@bootlin.com> In-Reply-To: <20251114-update-bbsetup-doc-v1-0-044070bdffec@bootlin.com> To: bitbake-devel@lists.openembedded.org Cc: Thomas Petazzoni , docs@lists.yoctoproject.org, Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=3586; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=1JAVIENtPn2+TJw7nc2gqUXfePZAxB06vxAb58eRCms=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpFw6r9HYVC+NExy3hJ78tG5eMxwiurxNBJo5RM bTg6PmDGHiJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaRcOqwAKCRDRgEFAKaOo Nhx8D/9Qb3O23vMq1Yn8MSY2wB6sksphDzFi+/EjIG4916/K85OmppTUek52GQpDW2n1EXj9qyN vPUujTLwrI0DnaHKpi7wmIcaASzuBa3apIZjo6m3TRJfwhxM5vbTCAJ59qUATPfAMAOuYCaF8rM W9xI3OD17M/X0VdO4vtxLyGe057wrKXQG9piOD8d6TLn5t4XQjyyFGcQUVF+TXj+ehETptT7zcs Fj9Bt3ebv+iER/wqvzbSw5TcuGXq3Y2wdu0aHRoqGrorjWZPhHS7046kDjgutvHAht0yFXIS3ig RYZm9H5GdydrMOx9lkCZYH68mCHxqc3ryLrZ9meFSMiTUNeBQOpeVubpx/91sYMW+wo2aMHh1Bv opWfGahdPD0mtAjnyN+MkMahhMLOVF5r7zUnXb4EVYgkzNoibln6QV8fIj3GypNdiZ/3wr3dZsQ UnHI6uvUxx2r3DSLcFZWy5+jKi+NDD/QG+cjnBEeZd8dM+JjaJ/i3zuh/pj95whk7/Fxlkznoso qZgo9+SbbPifBWX8Ey/igt48IVgZiCY7gJQtv6yUeRLes72yddRpjaigW/p4MCpoe263zSUFISP Mx1y5OjQHyJxqPX5H9iQYu3suMISnOwJWAu5X1r7lvN+2PzLjDNYmeIf2luH1zNgvsquU8IoNZt 9MGTpffJ/kReSJw== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Fri, 14 Nov 2025 11:12:59 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8038 This file is central to how bitbake-setup works and there was no mention of it. Add it to the quick start section and the terminology. Signed-off-by: Antonin Godard --- .../bitbake-user-manual-environment-setup.rst | 28 ++++++++++++++++++---- 1 file changed, 24 insertions(+), 4 deletions(-) diff --git a/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst b/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst index 91caeb041d..3193952972 100644 --- a/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst +++ b/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst @@ -51,9 +51,10 @@ Quick Start about ``bitbake-setup`` input configuration files. #. With the default choices, the ``bitbake-setup init`` command creates the - following directories:: + following files and directories:: ./bitbake-builds/ + ├── site.conf └── poky-master-poky-distro_poky-machine_qemux86-64/    ├── build/    ├── config/ @@ -83,6 +84,14 @@ Quick Start ` and other repositories managed by ``bitbake-setup`` are stored and updated. + - ``site.conf``: a BitBake configuration file that contains site specific + configurations for your build environment. When it is created, it contains + some variable definitions that are based on your current :term:`settings`. + Comments in this file will help you understand what these variables + correspond to. + + These configurations are shared between the :term:`setups `. + #. Source the ``init-build-env`` file present in the :term:`BitBake Build` directory: @@ -102,10 +111,11 @@ Terminology The ``bitbake-setup`` tool revolves around some common terms we define in this section. -``bitbake-setup`` works with a specific hierarchy of directories, that can be -represented as follows:: +``bitbake-setup`` works with a specific hierarchy of files and directories, that +can be represented as follows:: Top Directory + ├── site.conf ├── Setup 1 │   ├── build/ │ ├── config/ @@ -129,7 +139,8 @@ The "Top Directory" and "Setup" directories are defined as follows: :ref:`ref-bbsetup-setting-top-dir-name` settings. The top directory contains one or more :term:`Setup` directories, each of - them containing a :term:`Setup`. + them containing a :term:`Setup`, and a :term:`Site Configuration File` + (named ``site.conf``). :term:`Setup` A Setup is the result of the :ref:`ref-bbsetup-command-init` @@ -144,6 +155,15 @@ The "Top Directory" and "Setup" directories are defined as follows: ` or other repositories managed by ``bitbake-setup`` (``layers/`` directory). + :term:`Site Configuration File` + This file named ``site.conf`` is a unique file located in the :term:`Top + Directory`, and holds top-level BitBake configuration statements shared + between the :term:`Setups `. + + When it is created, it contains some variable definitions that are based + on your current :term:`settings`. Comments in this file will help you + understand what these variables correspond to. + The following components are involved to create the content of these directories: .. glossary::