12399 2017-12-06 00:27:55 +0000 add non conflicting parts of the bitbake manual to the mega manual 2019-02-14 22:37:07 +0000 1 1 9 Documentation Mega Manual mega-manual 2.5 x86 Multiple RESOLVED FIXED 14 February 2019: RESOLVED Medium+ normal 2.7 M2 1 brian.avery srifenbark bluelightning richard.purdie srifenbark --- --- Done (doc changes complete) oldest_to_newest 78531 0 brian.avery 2017-12-06 00:27:55 +0000 Some things, a great example from a question today is the assignment operators ?= and ??=, are addressed in the bitbake manual, but not really addressed in the mega manual. Many new users know about the mega manual as they associate the name yocto with the project and docs. Unfortunately, they do not realize that they should look in the bitbake manual for things that are not covered (or worse, are briefly covered) in the mega manual but whose real documentation is in the bitbake manual. 78532 1 brian.avery 2017-12-06 00:28:20 +0000 +paul and rp 78640 2 srifenbark 2017-12-08 22:34:44 +0000 One thing we try to avoid is duplication of information. I would rather scrub through the YP doc set and be sure that we are referencing the BB manual appropriately. I really don't want to take information that is in the BB manual and repeat it in the YP documentation manuals. Scott 78648 3 bluelightning 2017-12-10 21:40:44 +0000 The mega manual already is a duplication of the other YP manuals though. The idea here would be to include verbatim the specific section files from the bitbake manual, assuming that's practical to do without mondification. 78677 4 srifenbark 2017-12-11 22:10:25 +0000 Paul, Okay - I see the difference then. Brian is suggesting that we selectively include areas of the BB manual into the mega-manual as opposed to having that information duplicated somewhere in say the ref-manual and have it sucked into the mega-manual that way. 80055 5 srifenbark 2018-03-30 19:03:44 +0000 Maybe we should just include the BB manual in the mega-manual? What do you think of that idea? Scott 80550 6 richard.purdie 2018-05-10 08:23:47 +0000 Including it sounds fine to me fwiw. 80558 7 srifenbark 2018-05-10 09:16:12 +0000 I also like the idea of adding the BitBake manual to the mega-manual fwiw. I will add it in. Scott 81643 8 srifenbark 2018-09-26 20:31:37 +0000 Setting this to post 2.6. I will do this after "thud" Scott 82607 9 srifenbark 2018-12-27 00:41:43 +0000 Hi, This bug is complete for what we wanted to do, which is include the entire BitBake User Manual into the Mega-Manual (it was an agreed upon compromise). You can see http://www.yoctoproject.org/docs/2.7/mega-manual/mega-manual.html for the new manual that includes BB User Manual as the last manual in the mega-manual. Note that target ID strings for variables linked in the BB manual are now unique from target IDs used in the YP Reference Manual. So I think everything behind the scenes is good to go. Let me know... I am putting the bug in review. Scott 83007 10 richard.purdie 2019-02-14 16:14:34 +0000 This has now been completed, thanks Scott! 83012 11 srifenbark 2019-02-14 22:37:07 +0000 Thanks Richard, I have set the doc flag to "done". Scott