1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2025-01-17 05:32:45 +01:00
19239: Doc: document generate-makefile.ci r=maribu a=bergzand

### Contribution description

This documents the `generate-makefile.ci` target


### Testing procedure

Read the added section to the advanced build system tricks

### Issues/PRs references

None

Co-authored-by: Koen Zandberg <koen@bergzand.net>
This commit is contained in:
bors[bot] 2023-02-03 12:06:11 +00:00 committed by GitHub
commit 9027179fcc
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -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.