summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2011-09-26 10:13:56 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2011-10-04 13:46:37 +0100
commit87566447aa0000cb9213234d1bc6be0eab7a1d2f (patch)
tree2817d11488e1651f456b262cef0d0461dfe701dc /documentation
parentfe209e4fa4542b96168efb7e4998bb6052c5e7c3 (diff)
downloadpoky-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')
-rw-r--r--documentation/poky-ref-manual/extendpoky.xml60
1 files changed, 57 insertions, 3 deletions
diff --git a/documentation/poky-ref-manual/extendpoky.xml b/documentation/poky-ref-manual/extendpoky.xml
index 978aa20a47..efbc52f7cb 100644
--- a/documentation/poky-ref-manual/extendpoky.xml
+++ b/documentation/poky-ref-manual/extendpoky.xml
@@ -79,7 +79,8 @@
79 By default, the <filename>helloworld</filename>, <filename>helloworld-dbg</filename>, 79 By default, the <filename>helloworld</filename>, <filename>helloworld-dbg</filename>,
80 and <filename>helloworld-dev</filename> packages are built. 80 and <filename>helloworld-dev</filename> packages are built.
81 For information on how to customize the packaging process, see the 81 For information on how to customize the packaging process, see the
82 <link linkend='usingpoky-extend-addpkg-files'>Controlling Package Content</link> section. 82 "<link linkend='splitting-an-application-into-multiple-packages'>Splitting an Application
83 into Multiple Packages</link>" section.
83 </para> 84 </para>
84 </section> 85 </section>
85 86
@@ -174,8 +175,8 @@
174 </para> 175 </para>
175 </section> 176 </section>
176 177
177 <section id='usingpoky-extend-addpkg-files'> 178 <section id='splitting-an-application-into-multiple-packages'>
178 <title>Controlling Package Content</title> 179 <title>Splitting an Application into Multiple Packages</title>
179 180
180 <para> 181 <para>
181 You can use the variables <filename><link linkend='var-PACKAGES'>PACKAGES</link></filename> and 182 You can use the variables <filename><link linkend='var-PACKAGES'>PACKAGES</link></filename> and
@@ -222,6 +223,59 @@
222 </para> 223 </para>
223 </section> 224 </section>
224 225
226 <section id='including-static-library-files'>
227 <title>Including Static Library Files</title>
228
229 <para>
230 If you are building a library and the library offers static linking, you can control
231 which static library files (<filename>*.a</filename> files) get included in the
232 built library.
233 </para>
234
235 <para>
236 The <filename>PACKAGES</filename> and <filename>FILES_*</filename> variables in the
237 <filename>meta/conf/bitbake.conf</filename> configuration file define how files installed
238 by the <filename>do_install</filename> task are packaged.
239 By default, the <filename>PACKAGES</filename> variable contains
240 <filename>${PN}-staticdev</filename>, which includes all static library files.
241 <note>
242 Previously released versions of the Yocto Project defined the static library files
243 through <filename>${PN}-dev</filename>.
244 </note>
245 Following, is part of the BitBake configuration file.
246 You can see where the static library files are defined:
247 <literallayout class='monospaced'>
248 PACKAGES = "${PN}-dbg ${PN} ${PN}-doc ${PN}-dev ${PN}-staticdev ${PN}-locale"
249 PACKAGES_DYNAMIC = "${PN}-locale-*"
250 FILES = ""
251
252 FILES_${PN} = "${bindir}/* ${sbindir}/* ${libexecdir}/* ${libdir}/lib*${SOLIBS} \
253 ${sysconfdir} ${sharedstatedir} ${localstatedir} \
254 ${base_bindir}/* ${base_sbindir}/* \
255 ${base_libdir}/*${SOLIBS} \
256 ${datadir}/${BPN} ${libdir}/${BPN}/* \
257 ${datadir}/pixmaps ${datadir}/applications \
258 ${datadir}/idl ${datadir}/omf ${datadir}/sounds \
259 ${libdir}/bonobo/servers"
260
261 FILES_${PN}-doc = "${docdir} ${mandir} ${infodir} ${datadir}/gtk-doc \
262 ${datadir}/gnome/help"
263 SECTION_${PN}-doc = "doc"
264
265 FILES_${PN}-dev = "${includedir} ${libdir}/lib*${SOLIBSDEV} ${libdir}/*.la \
266 ${libdir}/*.o ${libdir}/pkgconfig ${datadir}/pkgconfig \
267 ${datadir}/aclocal ${base_libdir}/*.o"
268 SECTION_${PN}-dev = "devel"
269 ALLOW_EMPTY_${PN}-dev = "1"
270 RDEPENDS_${PN}-dev = "${PN} (= ${EXTENDPKGV})"
271
272 FILES_${PN}-staticdev = "${libdir}/*.a ${base_libdir}/*.a"
273 SECTION_${PN}-staticdev = "devel"
274 RDEPENDS_${PN}-staticdev = "${PN}-dev (= ${EXTENDPKGV})"
275 </literallayout>
276 </para>
277 </section>
278
225 <section id='usingpoky-extend-addpkg-postinstalls'> 279 <section id='usingpoky-extend-addpkg-postinstalls'>
226 <title>Post Install Scripts</title> 280 <title>Post Install Scripts</title>
227 281