Bug 12089

Summary: Need to document BBFILES_DYNAMIC
Product: [Documentation] BitBake User Manual Reporter: brian avery <brian.avery>
Component: bitbake-manualAssignee: Kristi <kristi>
Status: RESOLVED FIXED QA Contact:
Severity: normal    
Priority: Medium CC: bluelightning, kristi, richard.purdie, ross.burton, srifenbark
Version: 2.4   
Target Milestone: 2.5 M2   
Hardware: x86   
OS: Multiple   
Whiteboard: 05 February 2018: RESOLVED
OS type for building Yocto: --- Type of Regression: ---
Verified: Documentation change: Done (doc changes complete)

Description brian avery 2017-09-14 22:16:05 UTC
From the commit message:
    bitbake: cookerdata: Add support for BBFILES_DYNAMIC
    
    BBFILES_DYNAMIC can be used to activate content only when some other
    layers are present. The other layers are identified by the collections
    that they define.
    
    The main use case is to avoid .bbappends without the corresponding .bb
    file in layers that want to modify other layers via .bbappends without
    introducing a hard dependency on those other layers. .bb files could
    also be handled via BBFILES_DYNAMIC.
    
    Entries in BBFILES_DYNAMIC must have the form <collection
    name>:<filename pattern>. Example usage:
     BBFILES_DYNAMIC += " \
         clang-layer:${LAYERDIR}/bbappends/meta-clang/*/*/*.bbappend \
         core:${LAYERDIR}/bbappends/openembedded-core/meta/*/*/*.bbappend \
     "
    
    Parsing is aborted when invalid entries are found with an error
    message like this:
    
     ERROR: BBFILES_DYNAMIC entries must be of the form <collection name>:<filename pattern>, not:
         /work/my-layer/bbappends/meta-security-isafw/*/*/*.bbappend
         /work/my-layer/bbappends/openembedded-core/meta/*/*/*.bbappend
    
    Based on a patch by Richard Purdie.
Comment 1 brian avery 2017-09-14 22:20:07 UTC
adding interested parties.
Comment 2 Kristi 2017-09-15 16:15:50 UTC
Taking ownership of this one.
Comment 3 Kristi 2017-12-18 23:12:21 UTC
Brian - I've added this variable description to the glossary. Would you please take a look at http://www.yoctoproject.org/docs/2.5/ref-manual/ref-manual.html#var-BBFILES_DYNAMIC 

Let me know if additional changes are necessary. Thanks!
Comment 4 Ross Burton 2018-02-05 14:18:00 UTC
Fixed in 0906e9080e1c150feab60bb9d095688d274a061e.
Comment 5 Scott Rifenbark 2018-02-05 23:15:47 UTC
Setting Doc flag to "done".