public inbox for docs@lists.yoctoproject.org
 help / color / mirror / Atom feed
From: "Antonin Godard" <antonin.godard@bootlin.com>
To: "Quentin Schulz" <quentin.schulz@cherry.de>,
	<docs@lists.yoctoproject.org>
Cc: "Thomas Petazzoni" <thomas.petazzoni@bootlin.com>
Subject: Re: [docs] [PATCH v2 04/56] bsp-guide/bsp.rst: remove obsolete poky repo references
Date: Thu, 29 Jan 2026 12:17:25 +0100	[thread overview]
Message-ID: <DG114U9XCHNL.1C0474QCG0ZCC@bootlin.com> (raw)
In-Reply-To: <17c0f924-35d0-4d2b-b152-8ea5f7812676@cherry.de>

Hi,

On Tue Jan 27, 2026 at 12:27 PM CET, Quentin Schulz wrote:
[...]
> Actually, probably should be 4 and have two spaces between #. and 
> *Initialize* since that's the rule we have for lists. I see most of the 
> lists in the diff in this patch don't follow the rule so I guess that's 
> not a blocker :)

I actually think it makes more sense to have one space for "#.", as this way it
aligns with bullet lists "-  ":

#. foo
-  bar

>> -      $ source oe-init-build-env
>> +      $ source layers/openembedded-core/oe-init-build-env
>>   
>>      Among other things, the script creates the :term:`Build Directory`, which is
>> -   ``build`` in this case and is located in the :term:`Source Directory`.  After
>> -   the script runs, your current working directory is set to the ``build``
>> -   directory.
>> +   :term:`Build Directory`. After the script runs, your current working directory 
>
> s/:term:`Build Directory`/"build"/
>
> otherwise this says "Build Directory, which is Build Directory".
>
> is set to
>> +   the :term:`Build Directory` directory.
>> +
>> +   .. note::
>> +
>> +      Alternatively, you can source the ``init-build-env`` file provided by
>> +      :doc:`bitbake-setup <bitbake:bitbake-user-manual/bitbake-user-manual-environment-setup>`
>>   
>
> You didn't answer the question on v1 so posting it here again:
>
> Can we set up using bitbake-setup and then source oe-init-buildenv from
> oe-core? Or vice-versa. The wording seems to imply that.

I mean you could but probably you wouldn't want to?

> Isn't most the above not applicable if we use bitbake-setup anyway?

As you have seen from this series, for now, it doesn't force you into setting
things one way or another. A further step to this series would be to locate and
replace these with bitbake-setup specific instructions, dropping the manual
setup anywhere.

Thanks,
Antonin

-- 
Antonin Godard, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com



  reply	other threads:[~2026-01-29 11:17 UTC|newest]

Thread overview: 92+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-01-27  8:18 [PATCH v2 00/56] Remove obsolete poky repo references Antonin Godard
2026-01-27  8:18 ` [PATCH v2 01/56] transitioning-to-a-custom-environment.rst: remove " Antonin Godard
2026-01-27  8:18 ` [PATCH v2 02/56] dev-manual/poky-manual-setup.rst: " Antonin Godard
2026-01-27 10:55   ` [docs] " Quentin Schulz
2026-01-27  8:18 ` [PATCH v2 03/56] dev-manual/start.rst: " Antonin Godard
2026-01-27 11:14   ` [docs] " Quentin Schulz
2026-01-27  8:18 ` [PATCH v2 04/56] bsp-guide/bsp.rst: " Antonin Godard
2026-01-27 11:27   ` [docs] " Quentin Schulz
2026-01-29 11:17     ` Antonin Godard [this message]
2026-01-27  8:19 ` [PATCH v2 05/56] kernel-dev/advanced.rst: " Antonin Godard
2026-01-27 13:05   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 06/56] contributor-guide/submit-changes.rst: " Antonin Godard
2026-01-27 13:37   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 07/56] dev-manual/building.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 08/56] dev-manual/debugging.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 09/56] dev-manual/error-reporting-tool.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 10/56] dev-manual/external-toolchain.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 11/56] dev-manual/layers.rst: " Antonin Godard
2026-01-27 15:18   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 12/56] " Antonin Godard
2026-01-27 15:29   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 13/56] dev-manual/libraries.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 14/56] dev-manual/new-recipe.rst: " Antonin Godard
2026-01-27 15:39   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 15/56] dev-manual/securing-images.rst: " Antonin Godard
2026-01-27 15:44   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 16/56] dev-manual/temporary-source-code.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 17/56] dev-manual/wayland.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 18/56] dev-manual/wic.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 19/56] kernel-dev/common.rst: " Antonin Godard
2026-01-27 17:41   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 20/56] migration-guides/migration-1.4.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 21/56] overview-manual/concepts.rst: " Antonin Godard
2026-01-27 17:58   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 22/56] overview-manual/development-environment.rst: " Antonin Godard
2026-01-28 11:11   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 23/56] overview-manual/yp-intro.rst: " Antonin Godard
2026-01-28 11:32   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 24/56] ref-manual/classes.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 25/56] ref-manual/images.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 26/56] ref-manual/structure.rst: " Antonin Godard
2026-01-28 11:48   ` [docs] " Quentin Schulz
2026-01-29 14:11     ` Antonin Godard
2026-01-27  8:19 ` [PATCH v2 27/56] ref-manual/tasks.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 28/56] ref-manual/variables.rst: " Antonin Godard
2026-01-28 13:36   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 29/56] sdk-manual/appendix-obtain.rst: " Antonin Godard
2026-01-28 13:36   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 30/56] sdk-manual/intro.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 31/56] test-manual/runtime-testing.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 32/56] README: " Antonin Godard
2026-01-28 13:40   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 33/56] README: replace obsolete substitution variables Antonin Godard
2026-01-27  8:19 ` [PATCH v2 34/56] contributor-guide/identify-component.rst: remove obsolete poky repo references Antonin Godard
2026-01-27  8:19 ` [PATCH v2 35/56] dev-manual/build-quality.rst: " Antonin Godard
2026-01-28 13:41   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 36/56] dev-manual/custom-distribution.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 37/56] dev-manual/custom-template-configuration-directory.rst: " Antonin Godard
2026-01-28 13:47   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 38/56] dev-manual/init-manager.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 39/56] dev-manual/licenses.rst: " Antonin Godard
2026-01-28 13:54   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 40/56] dev-manual/licenses.rst: instruct to use git-archive instead of removing .git Antonin Godard
2026-01-28 13:57   ` Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 41/56] dev-manual/packages.rst: remove obsolete poky repo references Antonin Godard
2026-01-28 14:01   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 42/56] dev-manual/python-development-shell.rst: " Antonin Godard
2026-01-28 14:02   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 43/56] dev-manual/qemu.rst: " Antonin Godard
2026-01-28 14:03   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 44/56] dev-manual/upgrading-recipes.rst: " Antonin Godard
2026-01-28 14:09   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 45/56] dev-manual/vulnerabilities.rst: " Antonin Godard
2026-01-28 14:11   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 46/56] ref-manual/devtool-reference.rst: " Antonin Godard
2026-01-28 14:15   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 47/56] ref-manual/faq.rst: " Antonin Godard
2026-01-28 14:23   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 48/56] ref-manual/features.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 49/56] ref-manual/release-process.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 50/56] ref-manual/release-process.rst: remove repeated "in the" Antonin Godard
2026-01-28 14:27   ` Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 51/56] ref-manual/system-requirements.rst: remove obsolete poky repo references Antonin Godard
2026-01-28 14:48   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 52/56] ref-manual/system-requirements.rst: fix wrong path to install-buildtools Antonin Godard
2026-01-28 15:02   ` Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 53/56] ref-manual/yocto-project-supported-features.rst: remove obsolete poky repo reference Antonin Godard
2026-01-27  8:19 ` [PATCH v2 54/56] test-manual/reproducible-builds.rst: remove obsolete poky repo references Antonin Godard
2026-01-27  8:19 ` [PATCH v2 55/56] test-manual/understand-autobuilder.rst: " Antonin Godard
2026-01-28 15:03   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 56/56] what-i-wish-id-known.rst: " Antonin Godard
2026-01-28 15:08   ` [docs] " Quentin Schulz

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=DG114U9XCHNL.1C0474QCG0ZCC@bootlin.com \
    --to=antonin.godard@bootlin.com \
    --cc=docs@lists.yoctoproject.org \
    --cc=quentin.schulz@cherry.de \
    --cc=thomas.petazzoni@bootlin.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox