mbox series

[yocto-docs,v4,0/2] Document how to provide configuration from layer.conf

Message ID 20241113-layer-confs-v4-0-a4758fa4d1a8@bootlin.com
Headers show
Series Document how to provide configuration from layer.conf | expand

Message

Antonin Godard Nov. 13, 2024, 3:28 p.m. UTC
This series documents how to provide configurations from layer.conf, be
it unconditionally or conditionally. I wanted to reference a file in
bitbake, so I added the :bitbake_git: new term for that.

This is a attempt at closing
https://bugzilla.yoctoproject.org/show_bug.cgi?id=12688.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
Changes in v4:
- Fix include -> require mentions after being replaced in v2.
- Suggestions by Quentin:
  - until -> unless
  - it -> one
- Link to v3: https://lore.kernel.org/r/20241113-layer-confs-v3-0-3a84b0eb2750@bootlin.com

Changes in v3:
- Replace attention block by warning block.
- Create an anchor for the conditional confs section, I was getting a
  sphinx error.
- Rephrase the PREFERRED_PROVIDER sentence.
- More precision on PREFERRED_PROVIDER assignments, with other conf
  files..
- Link to v2: https://lore.kernel.org/r/20241112-layer-confs-v2-0-22a09f1a0a8e@bootlin.com

Changes in v2:
- Create an `.. attention::` block to tell users _not_ to set
  unconditional confs from layer.conf.
- Fix typos reported by Quentin (thanks!)
- Add "Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de>" on first
  commit (thanks!).
- Simplify "your layer is part of BBLAYERS"