docs/manual/adding-packages-directory.txt

1 // -*- mode:doc; -*-
9 Some packages have been grouped by topic in a sub-directory:
27 ---------------------------
35 ---------------------------
52 6. Any dependency of the +select+ form
55 You can add other sub-options into a +if BR2_PACKAGE_LIBFOO...endif+
59 available at http://kernel.org/doc/Documentation/kbuild/kconfig-language.txt[]
67 --------------------------
69 --------------------------
77 * The host package is only required to satisfy build-time
79   +host-foo+ to the target package's +BAR_DEPENDENCIES+ variable. No
86 ---------------------------
93 ---------------------------
101 --------------------------
103 --------------------------
107 [[depends-on-vs-select]]
108 ==== Choosing +depends on+ or +select+
114 * Use a +select+ type of dependency for dependencies on
118   +select BR2_PACKAGE_LIBGLIB2+ to make sure this library is also
120   The +select+ keyword expresses the dependency with a backward
126   toolchain options (see xref:dependencies-target-toolchain-options[]),
134 possible to select a package, whom one of its dependencies/requirement
137 An example illustrates both the usage of +select+ and +depends on+.
139 --------------------------
143 	select BR2_PACKAGE_FREETYPE
144 	select BR2_PACKAGE_LIBART
145 	select BR2_PACKAGE_LIBPNG
146 	select BR2_PACKAGE_ZLIB
155 --------------------------
163 --------------------------
177         select BR2_PACKAGE_B
181         select BR2_PACKAGE_D
182 --------------------------
188 * Selecting +Package E+ will select +Package D+, which will select
190   so it will not select +Package A+.
196 --------------------------
199 	select BR2_PACKAGE_B
204 	select BR2_PACKAGE_D
206 --------------------------
208 Overall, for package library dependencies, +select+ should be
216 Further formatting details: see xref:writing-rules-config-in[the
219 [[dependencies-target-toolchain-options]]
241 these non-toolchain option should be kept separate from the +depends on+
250 --------------------------
252 --------------------------
256 --------------------------
258 --------------------------
262 --------------------------
264 --------------------------
267 80-character terminal.
281 * Gcc +__sync_*+ built-ins used for atomic operations. They are
291 * Gcc +__atomic_*+ built-ins used for atomic operations.
312    host GCC version, but rather a host-package on which it depends.
361 --------------------------
363 --------------------------
368 --------------------------
370 --------------------------
377 --------------------------
379 --------------------------
384 --------------------------
386 --------------------------
393 See xref:virtual-package-tutorial[] for more on the virtual packages.
397 [[adding-packages-mk]]
408   autotools-based packages, but require a little more work from the
414   them through in a xref:generic-package-tutorial[tutorial] and a
415   xref:generic-package-reference[reference].
417 * *Makefiles for autotools-based software* (autoconf, automake, etc.):
421   system. We cover them through a xref:autotools-package-tutorial[tutorial]
422   and xref:autotools-package-reference[reference].
424 * *Makefiles for cmake-based software*: We provide a dedicated
428    CMake. We cover them through a xref:cmake-package-tutorial[tutorial]
429    and xref:cmake-package-reference[reference].
434    xref:python-package-tutorial[tutorial] and a
435    xref:python-package-reference[reference].
439    through a xref:luarocks-package-tutorial[tutorial] and a
440    xref:luarocks-package-reference[reference].
442 Further formatting details: see xref:writing-rules-mk[the writing
445 [[adding-packages-hash]]
469 ** for +none+, one or more non-space chars, usually just the string +xxx+
489 upstream, e.g. on their website, in the e-mail announcement... If upstream
498 package version is bumped. The hashes are checked during the make legal-info
501 (see also xref:patch-apply-order[]).
507 the main +libfoo-1.2.3.tar.bz2+ tarball, an +md5+ from upstream and a
508 locally-computed +sha256+ hashes for a binary blob, a +sha256+ for a
511 ----
512 # Hashes from: http://www.foosoftware.org/download/libfoo-1.2.3.tar.bz2.{sha1,sha256}:
513 sha1  486fb55c3efa71148fe07895fd713ea3a5ae343a  libfoo-1.2.3.tar.bz2
514 sha256  efc8103cc3bcb06bda6a781532d12701eb081ad83e8f90004b39ab81b65d4369  libfoo-1.2.3.tar.bz2
516 # md5 from: http://www.foosoftware.org/download/libfoo-1.2.3.tar.bz2.md5, sha256 locally computed:
517 md5  2d608f3c318c6b7557d551a5a09314f03452f1a1  libfoo-data.bin
518 sha256  01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b  libfoo-data.bin
521 sha256  ff52101fb90bbfc3fe9475e425688c660f46216d7e751c4bbdb1dc85cdccacb9  libfoo-fix-blabla.patch
524 none  xxx  libfoo-1234.tar.gz
529 ----
551 guaranteed to be stable. For example, patches auto-generated by Github