mbox series

[v3,0/7] Start switching the documentation to bitbake-setup

Message ID 20251106-bitbake-setup-v3-0-97db90f85f84@bootlin.com
Headers show
Series Start switching the documentation to bitbake-setup | expand

Message

Antonin Godard Nov. 6, 2025, 9:11 a.m. UTC
This series is a start for transitioning the documentation on instructing how
to build the reference poky distro with bitbake-setup instead of the
poky repository.

What this series does:

- Refreshing the local.conf and bblayers.conf documentation.
- Adding documentation for site.conf.
- Migrating the Quick Start Guide to bitbake-setup (thank you Tim Orling
  for the first iteration of this).
- Adding a new document to instruct how to set things up manually, using
  the different repositories that used to be part of the Poky
  repository.

There are still references to the poky repository in places in the
documentation. I will send updates to this series (or another one) as I
make progress on this. First, let's have some documentation on how to
use bitbake-setup, as a starting point.

Depends on: https://lists.openembedded.org/g/bitbake-devel/message/18241.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
Changes in v3:
- Add suggestions/corrections by Alex (thanks!)
- Add a patch to document core/yocto/root-login-with-empty-password.
- Add websockets note and mention buildtools.
- Use meta-raspberrypi as the example BSP layer.
- Link to v2: https://lore.kernel.org/r/20251103-bitbake-setup-v2-0-89fbb14cfbbd@bootlin.com

Changes in v2:
- Apply suggestions from Alex's reviews on v1 (thanks!):
  - change local.conf description
  - configure root login in local.conf
- Update references to use new bitbake documentation on bitbake-setup.
- Link to v1: https://lore.kernel.org/r/20251030-bitbake-setup-v1-0-f44a8a2b7c0b@bootlin.com

---
Antonin Godard (7):
      ref-manual/structure.rst: update the description of local.conf and bblayers.conf
      ref-manual/structure.rst: document the site.conf file
      brief-yoctoprojectqs: delete unused figures
      ref-manual/fragments.rst: document core/yocto/root-login-with-empty-password fragment
      brief-yoctoprojectqs: switch to bitbake-setup
      dev-manual: add a document to setup poky manually
      ref-manual/terms.rst: update Poky description

 .../brief-yoctoprojectqs/figures/bypqs-title.png   | Bin 14312 -> 0 bytes
 .../figures/yocto-project-transp.png               | Bin 8626 -> 0 bytes
 documentation/brief-yoctoprojectqs/index.rst       | 421 +++++++++++----------
 documentation/dev-manual/index.rst                 |   1 +
 documentation/dev-manual/poky-manual-setup.rst     | 128 +++++++
 documentation/ref-manual/fragments.rst             |   9 +
 documentation/ref-manual/structure.rst             |  70 +++-
 documentation/ref-manual/terms.rst                 |  19 +-
 8 files changed, 432 insertions(+), 216 deletions(-)
---
base-commit: 5cb37206ca0dfaa0dafabb28ebd546b591c88486
change-id: 20251027-bitbake-setup-d8f38b266b4d

Best regards,
--  
Antonin Godard <antonin.godard@bootlin.com>

Comments

Alexander Kanavin Nov. 6, 2025, 1:14 p.m. UTC | #1
On Thu, 6 Nov 2025 at 10:11, Antonin Godard via lists.yoctoproject.org
<antonin.godard=bootlin.com@lists.yoctoproject.org> wrote:
> Changes in v3:
> - Add suggestions/corrections by Alex (thanks!)
> - Add a patch to document core/yocto/root-login-with-empty-password.
> - Add websockets note and mention buildtools.
> - Use meta-raspberrypi as the example BSP layer.
> - Link to v2: https://lore.kernel.org/r/20251103-bitbake-setup-v2-0-89fbb14cfbbd@bootlin.com

Thanks, I think this is good to go.

Alex