13225 2019-03-14 14:33:12 +0000 Need better explanation of how recipes create packages 2024-10-29 10:22:25 +0000 1 1 9 Documentation Reference handbook 5.99 All Multiple RESOLVED FIXED October 17 2019: ACCEPTED Medium normal 5.2 M4 1 srifenbark antonin.godard bluelightning mark.morton michael.opdenacker poky.doc.watcher poky.watcher randy.macleod richard.purdie sscott --- --- Yes (doc changes required) oldest_to_newest 83264 0 srifenbark 2019-03-14 14:33:12 +0000 We need better documentation on how a recipe creates packages. This explanation would likely fit in the existing YP Overview and Concepts Manual where we describe the build process in some detail. I am filing this bug for Steve Scott <sscott@san.rr.com> who contacted the yocto@yoctoproject.org group asking about where to find documentation on this topic. Scott 83563 1 srifenbark 2019-04-17 00:18:12 +0000 Hi, I am calling out for some raw information here. How do recipes create packages? We have this section in the overview and concepts manual (https://yoctoproject.org/docs/2.7/overview-manual/overview-manual.html#bitbake-dev-environment) that breaks down the BitBake process. One of the sub-sections is about splitting packages. Can someone provide an overview of the process? Is all the information captured in that BitBake section referenced by the link in the previous paragraph? Thanks, Scott R. 85249 2 sscott 2019-10-07 17:45:29 +0000 Scott: The overview section of the manual does not provide an explanation that enables someone new to yocto project to grasp YP packaging. In fact, the section says, "The FILES variable defines the files that go into each package in PACKAGES. If you want details on how this is accomplished, you can look at package.bbclass." This is perhaps the most important concept, and the reader is referred to bbclass source code that is probably at this point still incomprehensible to a newbie. This link: https://dominion.thruhere.net/koen/OE/OE-usermanual.html#recipes_packages provides an excellent tutorial on YP packaging from a user's point of view. It is from an old OE manual, and I have not been able to find a copy of it archived on the OE site. I think you could almost copy this section verbatim into the YP Overview section on packaging. If there is some way to contribute to the documentation, I would be happy to give it a try. steve 85380 3 srifenbark 2019-10-17 16:48:48 +0000 Steve, Thanks for the link and the extra information on this bug. I have taken ownership of it from Richard and I will use the information in that link to fix up the Overview manual. Scott 85383 4 sscott 2019-10-17 17:14:25 +0000 Hi Scott: I was able to find a couple of other urls for the old oe manual: https://www.cumulations.com/img/openembedded-usermanual.pdf http://www.embeddedlinux.org.cn/OEManual/ You might want to archive the pdf version somewhere (perhaps include it in the YP archived documents). I was looking through it and it has a lot of good information. 85385 5 srifenbark 2019-10-17 17:30:35 +0000 Hey Steve... Thanks for additional doc. 100011 6 randy.macleod 2024-10-24 15:03:59 +0000 Bulk move of 5.1 M4 to 5.2 M2 as approved by AlexB. 100053 7 antonin.godard 2024-10-29 10:22:25 +0000 Documentation on package splitting was added by following commit: https://git.yoctoproject.org/yocto-docs/commit/?id=143c3cacdec36c9d7ab81c89bbcc12c0c3936bd9 Closing this bug.