diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2011-09-26 10:13:56 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2011-10-04 13:46:37 +0100 |
commit | 87566447aa0000cb9213234d1bc6be0eab7a1d2f (patch) | |
tree | 2817d11488e1651f456b262cef0d0461dfe701dc /documentation/poky-ref-manual/extendpoky.xml | |
parent | fe209e4fa4542b96168efb7e4998bb6052c5e7c3 (diff) | |
download | ast2050-yocto-poky-87566447aa0000cb9213234d1bc6be0eab7a1d2f.zip ast2050-yocto-poky-87566447aa0000cb9213234d1bc6be0eab7a1d2f.tar.gz |
documentation/poky-ref-manual/extendpoky.xml: New section on static library
I added a new section to the "Adding a Package" section. This section
describes how to define the *.a files for when you create a library
that has static linking. Response to a comment from Paul Eggleton.
(From yocto-docs rev: 64499006ecd1e6b7573f1955a2f6e2f1a9564ce8)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/poky-ref-manual/extendpoky.xml')
-rw-r--r-- | documentation/poky-ref-manual/extendpoky.xml | 60 |
1 files changed, 57 insertions, 3 deletions
diff --git a/documentation/poky-ref-manual/extendpoky.xml b/documentation/poky-ref-manual/extendpoky.xml index 978aa20..efbc52f 100644 --- a/documentation/poky-ref-manual/extendpoky.xml +++ b/documentation/poky-ref-manual/extendpoky.xml @@ -79,7 +79,8 @@ By default, the <filename>helloworld</filename>, <filename>helloworld-dbg</filename>, and <filename>helloworld-dev</filename> packages are built. For information on how to customize the packaging process, see the - <link linkend='usingpoky-extend-addpkg-files'>Controlling Package Content</link> section. + "<link linkend='splitting-an-application-into-multiple-packages'>Splitting an Application + into Multiple Packages</link>" section. </para> </section> @@ -174,8 +175,8 @@ </para> </section> - <section id='usingpoky-extend-addpkg-files'> - <title>Controlling Package Content</title> + <section id='splitting-an-application-into-multiple-packages'> + <title>Splitting an Application into Multiple Packages</title> <para> You can use the variables <filename><link linkend='var-PACKAGES'>PACKAGES</link></filename> and @@ -222,6 +223,59 @@ </para> </section> + <section id='including-static-library-files'> + <title>Including Static Library Files</title> + + <para> + If you are building a library and the library offers static linking, you can control + which static library files (<filename>*.a</filename> files) get included in the + built library. + </para> + + <para> + The <filename>PACKAGES</filename> and <filename>FILES_*</filename> variables in the + <filename>meta/conf/bitbake.conf</filename> configuration file define how files installed + by the <filename>do_install</filename> task are packaged. + By default, the <filename>PACKAGES</filename> variable contains + <filename>${PN}-staticdev</filename>, which includes all static library files. + <note> + Previously released versions of the Yocto Project defined the static library files + through <filename>${PN}-dev</filename>. + </note> + Following, is part of the BitBake configuration file. + You can see where the static library files are defined: + <literallayout class='monospaced'> + PACKAGES = "${PN}-dbg ${PN} ${PN}-doc ${PN}-dev ${PN}-staticdev ${PN}-locale" + PACKAGES_DYNAMIC = "${PN}-locale-*" + FILES = "" + + FILES_${PN} = "${bindir}/* ${sbindir}/* ${libexecdir}/* ${libdir}/lib*${SOLIBS} \ + ${sysconfdir} ${sharedstatedir} ${localstatedir} \ + ${base_bindir}/* ${base_sbindir}/* \ + ${base_libdir}/*${SOLIBS} \ + ${datadir}/${BPN} ${libdir}/${BPN}/* \ + ${datadir}/pixmaps ${datadir}/applications \ + ${datadir}/idl ${datadir}/omf ${datadir}/sounds \ + ${libdir}/bonobo/servers" + + FILES_${PN}-doc = "${docdir} ${mandir} ${infodir} ${datadir}/gtk-doc \ + ${datadir}/gnome/help" + SECTION_${PN}-doc = "doc" + + FILES_${PN}-dev = "${includedir} ${libdir}/lib*${SOLIBSDEV} ${libdir}/*.la \ + ${libdir}/*.o ${libdir}/pkgconfig ${datadir}/pkgconfig \ + ${datadir}/aclocal ${base_libdir}/*.o" + SECTION_${PN}-dev = "devel" + ALLOW_EMPTY_${PN}-dev = "1" + RDEPENDS_${PN}-dev = "${PN} (= ${EXTENDPKGV})" + + FILES_${PN}-staticdev = "${libdir}/*.a ${base_libdir}/*.a" + SECTION_${PN}-staticdev = "devel" + RDEPENDS_${PN}-staticdev = "${PN}-dev (= ${EXTENDPKGV})" + </literallayout> + </para> + </section> + <section id='usingpoky-extend-addpkg-postinstalls'> <title>Post Install Scripts</title> |