1973 2012-02-09 14:45:21 +0000 Enhance BitBake manual 2014-04-10 19:45:45 +0000 1 1 7 Build System, Metadata & Runtime BitBake bitbake unspecified x86 Multiple RESOLVED FIXED 10 April 2014: RESOLVED Medium enhancement 1.6 1 josh srifenbark btraynor jefro jessica.zhang poky.bs.watcher poky.watcher richard.purdie srifenbark --- --- Done (doc changes complete) oldest_to_newest 18571 0 josh 2012-02-09 14:45:21 +0000 The BitBake manual is looking stale and out of date. Since we reference it from the Poky Reference Manual we should probably take the time to ensure the data is correct and add some more sections (particularly around the fetcher documentation). Additionally we should probably consider finding a new host for the manual as Berlios is going to go away. 29886 1 richard.purdie 2013-02-16 23:07:34 +0000 Scott, this probably should go to Bill but he doesn't have a bugzilla account? 30433 2 jefro 2013-03-05 01:57:53 +0000 Bill Traynor has been rewriting the BitBake manual. I don't know whether it will be finished in time for 1.4 but I believe that is the plan. Joshua, should we add you to the review committee? I believe the plan also is to host the manual on the YP servers and mirror it for OE. Scott, does that sound ok to you? 30631 3 srifenbark 2013-03-11 22:47:03 +0000 Yes - we can host the built versions of the manual alongside all the other YP documents. Are the plans to provide the manual files inside poky/bitbake/doc/manual as they are now? poky/documentation has actual .XML source files for the YP manuals. Bitbake manual does not follow this model. Scott 30900 4 srifenbark 2013-03-20 15:19:50 +0000 Here is how we will distribute the revised BB manual. * the "made" manuals will live alongside the current YP manuals on the yoctoproject.org server. Before release time I will make a current version and an in progress version from the OE git repository. I will publish these to the server, respectively. Users will be able to access the manuals from the list of YP documentation. * the repository for the BB manual will continue to live where it does with OE so that will not disrupt people that understand where it is. * when Bill Traynor has Richard Purdie pull his area (wmat) into the OE repo, the result will be a yocto-ized structure that has multiple chapters, make file, etc. this will be done before the 1.4 release at some point. Bill is targeting end of March 2013 to lock it up. At that point, he will tag the repo so we have a good 1.4 commit for the manual. Work can continue on the tip where it can be incorporated into the "in progress" result just as we do with the YP manuals. Scott 30901 5 srifenbark 2013-03-20 15:20:52 +0000 Added Richard to the CC list. 36926 6 srifenbark 2013-09-19 00:50:50 +0000 Unfortunately, this did not happen for 1.5. I think we are going to have to do it ourselves. I am pushing to post 1.5. 38389 7 srifenbark 2013-10-31 18:18:46 +0000 Setting the target to 1.6. This re-write needs to happen for 1.6. I will need to work with Richard and Paul to get this revision completed. 42071 8 srifenbark 2014-04-01 22:35:22 +0000 Changing the state on this to REVIEW. We are pretty far along on it and have just one last section to look at on EXPORT_FUNCTIONS. Also, I don't think the "Hello World" appendix is going to make it. Scott 42166 9 srifenbark 2014-04-02 13:54:58 +0000 Hi, Here is a link to the manual that is still in progress. The final appendix, which is the "hello world" example is not complete and might not make it into the final version. http://www.yoctoproject.org/docs/1.6/user-manual/user-manual.html Thanks, Scott 42577 10 srifenbark 2014-04-10 19:45:45 +0000 Hi, I am marking this one RESOLVED and the documentation flag to "Done." I think we have enhanced the manual. Scott