From fc471d659d7b77c2d1a73088aadfe534424f7200 Mon Sep 17 00:00:00 2001 From: Koen Zandberg Date: Fri, 3 Feb 2023 10:53:41 +0100 Subject: [PATCH] Doc: document generate-makefile.ci --- doc/doxygen/src/advanced-build-system-tricks.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/doc/doxygen/src/advanced-build-system-tricks.md b/doc/doxygen/src/advanced-build-system-tricks.md index 1a8c68a27847..7e06c71fd225 100644 --- a/doc/doxygen/src/advanced-build-system-tricks.md +++ b/doc/doxygen/src/advanced-build-system-tricks.md @@ -72,3 +72,17 @@ To do a repository wide analysis, you can use the script `dist/tools/buildsystem_sanity_check/save_all_dependencies_resolution_variables.sh` that will generate the output for all boards and applications. It currently take around 2 hours on an 8 cores machine with ssd. + +Generate Makefile.ci content {#generate-makefileci} +============================ + +Most applications and tests include a `Makefile.ci` to indicate which boards can +not compile the application or test. The content for these files can be +generated via the script in +~~~~~~~~~~~~~~~~~~~ +make -C $APPLICATION_DIRECTORY generate-Makefile.ci +~~~~~~~~~~~~~~~~~~~ +This will compile and link the application for every board available and record +the result in the Makefile.ci. This requires the toolchain for every target to +be available. The target supports using docker via the `BUILD_IN_DOCKER=1` +variable.