Skip to content

Commit 98e4e87

Browse files
committed
CI: Update doc for testbuild
Update doc for testbuild. Signed-off-by: Lup Yuen Lee <luppy@appkaki.com>
1 parent 694685a commit 98e4e87

1 file changed

Lines changed: 10 additions & 1 deletion

File tree

Documentation/components/tools/testbuild.rst

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ option shows the usage:
2323
-a <appsdir> provides the relative path to the apps/ directory. Default ../apps
2424
-t <topdir> provides the absolute path to top nuttx/ directory. Default ../nuttx
2525
-p only print the list of configs without running any builds
26-
-A store the build executable artifact in ARTIFACTDIR (defaults to ../buildartifacts
26+
-A store the build executable artifact in ARTIFACTDIR (defaults to ../buildartifacts)
2727
-C Skip tree cleanness check.
2828
-G Use "git clean -xfdq" instead of "make distclean" to clean the tree.
2929
This option may speed up the builds. However, note that:
@@ -73,3 +73,12 @@ The prefix ``-`` can be used to skip a configuration::
7373
or skip a configuration on a specific host(e.g. Darwin)::
7474

7575
-Darwin,sim:rpserver
76+
77+
This script will rebuild each configuration, upon failure, up to 7 times.
78+
Each rebuild will be attempted after a randomised delay with exponential
79+
backoff, initially set to 60 seconds. The rebuilds will mitigate the
80+
effects of intermittent download failures that occur in GitHub Actions.
81+
82+
If the build fails after 7 retries, subsequent configurations will not
83+
be allowed to rebuild upon failure. This is to prevent cascading build
84+
failures from overloading GitHub Actions.

0 commit comments

Comments
 (0)