ccache.bbclass
- The ccache class enables this cache for the build.
+ The ccache class enables the
+ C/C++ Compiler Cache
+ for the build.
This class is used to give a minor performance boost during the build.
However, using the class can lead to unexpected side-effects.
Thus, it is recommended that you do not use this class.
@@ -360,7 +362,9 @@
The chrpath class
is a wrapper around the "chrpath" utility, which is used during the
- build process for nativesdk recipes to change
+ build process for nativesdk,
+ cross, and
+ cross-canadian recipes to change
RPATH records within binaries in order to make
them relocatable.
@@ -373,6 +377,12 @@
The clutter class consolidates the
major and minor version naming and other common items used by Clutter
and related recipes.
+
+ Unlike some other classes related to specific libraries, recipes
+ building other software that uses Clutter do not need to
+ inherit this class unless they use the same recipe versioning
+ scheme that the Clutter and related recipes do.
+
@@ -454,8 +464,8 @@
cross.bbclass
- The cross)class provides support for
- cross-compilation tools.
+ The cross class provides support for the recipes
+ that build the cross-compilation tools.
@@ -464,7 +474,8 @@
The cross-canadian class
- provides support for Canadian Cross compilation tools for SDKs.
+ provides support for the recipes that build the Canadian
+ Cross-compilation tools for SDKs.
See the
"Cross-Development Toolchain Generation"
section for more discussion on these cross-compilation tools.
@@ -476,8 +487,8 @@
The crosssdk class
- provides support for cross-compilation tools used for building
- SDKs.
+ provides support for the recipes that build the cross-compilation
+ tools used for building SDKs.
See the
"Cross-Development Toolchain Generation"
section for more discussion on these cross-compilation tools.
@@ -488,10 +499,20 @@
debian.bbclass
- The debian class renames packages so that they
- follow the Debian naming policy (i.e. eglibc
+ The debian class renames output packages so that
+ they follow the Debian naming policy (i.e. eglibc
becomes libc6 and eglibc-devel
becomes libc6-dev.)
+ Renaming includes the library name and version as part of the package
+ name.
+
+
+
+ If a recipe creates packages for multiple libraries
+ (shared object files of .so type), use the
+ LEAD_SONAME
+ variable in the recipe to specify the library on which to apply the
+ naming scheme.
@@ -512,6 +533,9 @@
and use addtask to add the task at the appropriate
place, which is usually after do_compile or
do_install.
+ The class then takes care of staging the files from
+ DEPLOYDIR to
+ DEPLOY_DIR_IMAGE.
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 4a0e4d1047..2f3aafacc6 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -3514,6 +3514,23 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
+ LEAD_SONAME
+
+
+ Specifies the lead (or primary) compiled library file
+ (.so) that the
+ debian
+ class applies its naming policy to given a recipe that
+ packages multiple libraries.
+
+
+
+ This variable works in conjunction with the
+ debian class.
+
+
+
+
LIC_FILES_CHKSUMChecksums of the license text in the recipe source code.