diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml index 89bad481f4..70f12d0690 100644 --- a/documentation/ref-manual/ref-classes.xml +++ b/documentation/ref-manual/ref-classes.xml @@ -1406,24 +1406,28 @@
- Packaging - <filename>package*.bbclass</filename> + <filename>package.bbclass</filename> - The packaging classes add support for generating packages from a build's - output. - The core generic functionality is in package.bbclass. - The code specific to particular package types is contained in various sub-classes such as - package_deb.bbclass, package_ipk.bbclass, - and package_rpm.bbclass. - Most users will want one or more of these classes. + The packaging class (package) supports generating + packages from a build's output. + The core generic functionality is in the + package.bbclass. + The code specific to particular package types resides in these + package-specific classes: + package_deb, + package_rpm, + package_ipk, + and + package_tar. You can control the list of resulting package formats by using the PACKAGE_CLASSES - variable defined in the local.conf configuration file, - which is located in the conf folder of the - Source Directory. + variable defined in your conf/local.conf + configuration file, which is located in the + Build Directory. When defining the variable, you can specify one or more package types. Since images are generated from packages, a packaging class is needed to enable image generation. @@ -1441,8 +1445,8 @@ - The package class you choose can affect build-time performance and has space - ramifications. + The package-specific class you choose can affect build-time performance + and has space ramifications. In general, building a package with IPK takes about thirty percent less time as compared to using RPM to build the same or similar package. This comparison takes into account a complete build of the package with @@ -1451,17 +1455,18 @@ creates and processes more Metadata than the IPK package manager. - Consequently, you might consider setting PACKAGE_CLASSES - to "package_ipk" if you are building smaller systems. + Consequently, you might consider setting + PACKAGE_CLASSES to "package_ipk" if you are + building smaller systems. - Before making your decision on package manager, however, you should + Before making your package manager decision, however, you should consider some further things about using RPM: RPM starts to provide more abilities than IPK due to - the fact that it processes more metadata. + the fact that it processes more Metadata. For example, this information includes individual file types, file checksum generation and evaluation on install, sparse file support, conflict detection and resolution for Multilib systems, @@ -1487,6 +1492,78 @@
+
+ <filename>package_deb.bbclass</filename> + + + The Debian package manager (package_deb) class + provides support for creating packages that use the + .deb file format. + The class ensures the packages are written out to the + ${DEPLOY_DIR}/deb + directory in a .deb file format. + + This package inherits the + package + class. + + +
+ +
+ <filename>package_rpm.bbclass</filename> + + + The RPM package manager (package_deb) class + provides support for creating packages that use the + .rpm file format. + The class ensures the packages are written out to the + ${DEPLOY_DIR}/rpm + directory in a .rpm file format. + + This package inherits the + package + class. + + +
+ +
+ <filename>package_ipk.bbclass</filename> + + + The Itsy package manager (package_ipk) class + provides support for creating packages that use the + .ipk file format. + The class ensures the packages are written out to the + ${DEPLOY_DIR}/ipk + directory in a .ipk file format. + + This package inherits the + package + class. + + +
+ +
+ <filename>package_tar.bbclass</filename> + + + The consolidated Unix archive file (package_tar) + class provides support for creating packages that use the + .tar file format. + The class ensures the packages are written out to the + ${DEPLOY_DIR}/tar + directory in a .tar file format. + + This package inherits the + package + class. + + +
+
Building Kernels - <filename>kernel.bbclass</filename>