[PATCH v2 0/2] doc: bitbake-user-manual-metadata: list known limitations for shell task

[Quentin Schulz <foss+yocto@0leil.net>]

This fixes an inconsistency regarding the (sub)subsection level used for
all directives, which inherit_defer doesn't respect.

This adds a section for listing limitations for the BitBake shell
parser.

It does seem we have other limitations, specifically everything after
the parameter expansion table[1]. Only ${#parameter} does something,
returning 0, the others return the empty string instead. Maybe we want
to add that to the limitations?

[1] https://pubs.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html#tag_18_06_02

Signed-off-by: Quentin Schulz <quentin.schulz@cherry.de>
---
Changes in v2:
- added patch 1 which promote inherit_defer directive subsubsection into
  a subsection to match other directives,
- fixed embedded anonymous link syntax by not using one at all,
- removed bashism example from limitations subsubsection,
- added bashism-replacement example next to where we specify tasks are
  run with /bin/sh,
- Link to v1: https://patch.msgid.link/20260121-shell-invalid-v1-1-3d49dfcd78a7@cherry.de

---
Quentin Schulz (2):
      doc: bitbake-user-manual-metadata: promote inherit_defer directive to subsection
      doc: bitbake-user-manual-metadata: list known limitations for shell tasks

 .../bitbake-user-manual-metadata.rst                 | 20 ++++++++++++++++++--
 1 file changed, 18 insertions(+), 2 deletions(-)
---
base-commit: bc8be83aef0a6de85cd33a6f132f281d518594f7
change-id: 20260121-shell-invalid-23639a4f43ce

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