From c71dbcf34a6a2ecbf8df4b0cf5d599314a58edd4 Mon Sep 17 00:00:00 2001 From: Brandon Maier Date: Tue, 13 Oct 2020 17:36:02 -0500 Subject: [PATCH] docs/manual: add section about br2-external skeleton Signed-off-by: Brandon Maier [yann.morin.1998@free.fr: - alphabetical order (skeleton before toolchain) - leave the list of choices 'open' ] Signed-off-by: Yann E. MORIN --- docs/manual/customize-outside-br.txt | 30 ++++++++++++++++++++++++---- 1 file changed, 26 insertions(+), 4 deletions(-) diff --git a/docs/manual/customize-outside-br.txt b/docs/manual/customize-outside-br.txt index 5f7d623aea..2c3bc5243d 100644 --- a/docs/manual/customize-outside-br.txt +++ b/docs/manual/customize-outside-br.txt @@ -191,9 +191,9 @@ tree. 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 @@ a set of files that define those alternatives: * +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 @@ illustration, of course): | |$(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" -- 2.30.2