docs/manual: add section about br2-external skeleton
Signed-off-by: Brandon Maier <brandon.maier@rockwellcollins.com>
[yann.morin.1998@free.fr:
- alphabetical order (skeleton before toolchain)
- leave the list of choices 'open'
]
Signed-off-by: Yann E. MORIN <yann.morin.1998@free.fr>
diff --git a/docs/manual/customize-outside-br.txt b/docs/manual/customize-outside-br.txt
index 5f7d623..2c3bc52 100644
--- a/docs/manual/customize-outside-br.txt
+++ b/docs/manual/customize-outside-br.txt
@@ -191,9 +191,9 @@
For some packages, Buildroot provides a choice between two (or more)
implementations of API-compatible such packages. For example, there is
-a choice to choose either libjpeg ot jpeg-turbo, and another choice
-between openssl or libressl. Finally, there is a choice to select one
-of the known, pre-configured toolchains.
+a choice to choose either libjpeg ot jpeg-turbo; there is one between
+openssl or libressl; there is one to select one of the known,
+pre-configured toolchains...
It is possible for a br2-external to extend those choices, by providing
a set of files that define those alternatives:
@@ -201,7 +201,8 @@
* +provides/toolchains.in+ defines the pre-configured toolchains, which
will then be listed in the toolchain selection;
* +provides/jpeg.in+ defines the alternative libjpeg implementations;
-* +provides/openssl.in+ defines the alternative openssl implementations.
+* +provides/openssl.in+ defines the alternative openssl implementations;
+* +provides/skeleton.in+ defines the alternative skeleton implementations.
===== Free-form content
@@ -301,6 +302,27 @@
| |$(eval $(autotools-package))
| `----
|
+ |- provides/skeleton.in
+ | |config BR2_ROOTFS_SKELETON_MINE
+ | | bool "my custom skeleton"
+ | | select BR2_PACKAGE_SKELETON_MINE
+ | `----
+ |- package/skeleton-mine/Config.in
+ | |config BR2_PACKAGE_SKELETON_MINE
+ | | bool
+ | | select BR2_PACKAGE_HAS_SKELETON
+ | |
+ | |config BR2_PACKAGE_PROVIDES_SKELETON
+ | | default "skeleton-mine" if BR2_PACKAGE_SKELETON_MINE
+ | `----
+ |- package/skeleton-mine/skeleton-mine.mk
+ | |SKELETON_MINE_ADD_TOOLCHAIN_DEPENDENCY = NO
+ | |SKELETON_MINE_ADD_SKELETON_DEPENDENCY = NO
+ | |SKELETON_MINE_PROVIDES = skeleton
+ | |SKELETON_MINE_INSTALL_STAGING = YES
+ | |$(eval $(generic-package))
+ | `----
+ |
|- provides/toolchains.in
| |config BR2_TOOLCHAIN_EXTERNAL_MINE
| | bool "my custom toolchain"
