Bug 807

Summary: BBFILE_PRIORITY variable definition should explain how priority ordering works
Product: [Documentation] Reference Reporter: Joshua Lock - Disabled <josh>
Component: handbookAssignee: Scott Rifenbark <srifenbark>
Status: VERIFIED FIXED QA Contact:
Severity: normal    
Priority: Medium CC: gary, poky.doc.watcher, poky.watcher, sgw
Version: unspecified   
Target Milestone: 1.0 M4   
Hardware: x86   
OS: Multiple   
Whiteboard: 22 July 2011 - Verified
OS type for building Yocto: --- Type of Regression: ---
Verified: Documentation change: ---
Attachments:
Description Flags
Attempt at updating the BBFILE_PRIORITY variables documentation none

Description Joshua Lock - Disabled 2011-03-04 02:25:48 UTC
Reading the code leads me to the conclusion that higher numbers are better. I feel it would be useful to point this out to readers, possible at the variable definition in the Variables Glossary?
Comment 1 Gary Thomas 2011-03-04 04:20:26 UTC
It would also be good to mention that this is fully overriding.  For example,
if you have these recipe selections:
  layer-A/package/recipe_1.0.bb
  layer-B/package/recipe_1.2.bb

If layer-A is higher priority than layer-B, recipe_1.0 will be used.  To me,
at least, this is not intuitive.

It can be even more confusing with bbappend files.  I had an example like this:
  layer-A/package/recipe_1.0.bbappend
  layer-B/package/recipe_1.0.bb
  layer-B/package/recipe_1.2.bb
Again, if layer-A is higher priority, version 1.0 was built.  I'm not sure
what would be the result if the layer-B version 1.0 was deprecated and removed.

All in all, just confusing.  I ended up keeping all my layers the same priority
as the core layers I extend upon.
Comment 2 Joshua Lock - Disabled 2011-05-02 21:10:08 UTC
I think you can argue for both ways but we definitely need to document that, thanks for pointing that out Gary.
Comment 3 Joshua Lock - Disabled 2011-05-02 21:33:22 UTC
Created attachment 143 [details]
Attempt at updating the BBFILE_PRIORITY variables documentation

Here's an attempt at enhancing the documentation for this variable, it could probably do with a writers touch.
Comment 4 Scott Rifenbark 2011-05-04 16:57:15 UTC
Sent some feedback to Josh on the wording of the fix.  Once we bottom out I will update the bug with the final wording.
Comment 5 Scott Rifenbark 2011-05-09 12:04:21 UTC
I have updated the description of BBFILE_PRIORITY in the Poky Reference Manual.  I worked with Tom Zanussi on creating the final version of the text.  The change has been commited and pushed to the yocto-docs repo and when merged with the Poky repo by either Saul or RP the bug can be closed.
Comment 6 Joshua Lock - Disabled 2011-05-12 15:17:27 UTC
Hey Scott, Isn't that my input rather than Tom's?
Comment 7 Scott Rifenbark 2011-05-12 17:05:46 UTC
I mistakenly had Tom Zanussi mentioned as the person I worked with on this text.  It was actually Joshua Lock.  Sorry about that.
Comment 9 Scott Rifenbark 2011-07-22 07:49:54 UTC
Fixes are in