mbox series

[0/4] doc: bitbake-user-manual-ref-variables: clarify BBMASK examples

Message ID 20260211-bbmask-slashes-v1-0-b72161c647ef@cherry.de
Headers show
Series doc: bitbake-user-manual-ref-variables: clarify BBMASK examples | expand

Message

Quentin Schulz Feb. 11, 2026, 6:06 p.m. UTC
Robert reported being confused by the leading slash inconsistencies in
our BBMASK examples and wondered if it had any significance. After
reading the code and testing, it does, so this tries to explain the
difference and why you would want a leading slash in most cases.

It also explains that still with only a leading slash there could be
involuntary matches, which one should be able to get rid of by using
BBFILE_PATTERN from the layer they want to mask recipe or append files
from.

While at it, update the meta-ti example such that it matches what's
currently in the repo (migrated in kirkstone from a single meta-ti git
repo layer to a meta-ti git repo with multiple layers, such as
meta-ti-bsp).

Signed-off-by: Quentin Schulz <quentin.schulz@cherry.de>
---
Quentin Schulz (4):
      doc: bitbake-user-manual-ref-variables: clarify BBMASK directory matching
      doc: bitbake-user-manual-ref-variables: have directory examples be consistent
      doc: bitbake-user-manual-ref-variables: clarify BBMASK matching patterns
      doc: bitbake-user-manual-ref-variables: update BBMASK example with current meta-ti

 .../bitbake-user-manual-ref-variables.rst          | 30 +++++++++++++++++++---
 1 file changed, 26 insertions(+), 4 deletions(-)
---
base-commit: af9dd012e7f4d16dccd1d6118be5da94ede68f85
change-id: 20260211-bbmask-slashes-7ea904bf6347

Best regards,
--  
Quentin Schulz <quentin.schulz@cherry.de>

Comments

Robert P. J. Day Feb. 11, 2026, 8:45 p.m. UTC | #1
On Wed, 11 Feb 2026, Quentin Schulz via lists.yoctoproject.org wrote:

> Robert reported being confused by the leading slash inconsistencies
> in our BBMASK examples and wondered if it had any significance.
> After reading the code and testing, it does, so this tries to
> explain the difference and why you would want a leading slash in
> most cases.

  thanks, quentin, for tolerating my relentless whining about stuff
and proceeding to resolve it. i will try to get back to contributing
some of my own stuff in the near future. i already have plenty of
ideas for docs improvement.

rday