Bug 15640

Summary: The "inherit_defer" directive is not documented
Product: [Documentation] BitBake User Manual Reporter: Yoann Congal <yoann.congal>
Component: bitbake-manualAssignee: Antonin Godard <antonin.godard>
Status: RESOLVED FIXED QA Contact:
Severity: normal    
Priority: Medium+ CC: ccasciato, randy.macleod, richard.purdie, yoann.congal
Version: unspecified   
Target Milestone: 5.2 M2   
Hardware: x86   
OS: Multiple   
Whiteboard:
OS type for building Yocto: --- Type of Regression: ---
Verified: Documentation change: Yes (doc changes required)

Description Yoann Congal 2024-11-05 08:23:48 UTC
Maybe as a note in the "3.4.2 inherit Directive" section?
https://docs.yoctoproject.org/bitbake/dev/bitbake-user-manual/bitbake-user-manual-metadata.html#inherit-directive
Comment 1 Yoann Congal 2024-11-05 08:26:51 UTC
The best existing doc I could find: 
Scarthgap release notes: https://docs.yoctoproject.org/5.0.4/migration-guides/release-notes-5.0.html#new-features-enhancements-in-5-0

> BitBake improvements:
> New inherit_defer statement which works as inherit does, except that it is only evaluated at the end of parsing — recommended where a conditional expression is used, e.g.:
>    inherit_defer ${@bb.utils.contains('PACKAGECONFIG', 'python', 'python3targetconfig', '', d)}
> This allows conditional expressions to be evaluated ‘late’ meaning changes to the variable after the line is parsed will take effect - with inherit this is not the case.
Comment 2 Antonin Godard 2024-11-21 12:51:56 UTC
Patch sent on mailing list:

https://lists.openembedded.org/g/bitbake-devel/topic/bitbake_devel_patch_v2_doc/109681504

Awaiting review.
Comment 3 Antonin Godard 2024-12-04 08:20:29 UTC
We now have documentation for inherit_defer, after this commit was merged:
https://git.openembedded.org/bitbake/commit/?id=eb10df5a9619e243e28e0f4cd6122c24ed668f52

Closing this bug