Skip to content

Commit 793ab9e

Browse files
committed
doc: add doc on adding new target
Signed-off-by: Marc Poulhiès <[email protected]>
1 parent 7413fb2 commit 793ab9e

File tree

1 file changed

+29
-0
lines changed

1 file changed

+29
-0
lines changed

README.md

+29
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,35 @@
33
The repository is part of the [Compiler Explorer](https://godbolt.org/) project. It builds
44
the docker images used to build the various GCC cross-compilers used on the site.
55

6+
## How to add a new target
7+
8+
- create a ct-ng config:
9+
- can be based on a ct-ng sample
10+
- can be a new config
11+
- disable PROGRESS_BAR and any gdb features
12+
- check it builds correctly:
13+
`./ct-ng build`
14+
- copy the config in this repository in `build/latest` following the naming convention.
15+
- use `local_build.sh` to build it within the docker container
16+
`./local_build.sh arm64 13.2.0`
17+
- add ct-ng config and commit (and open a Pull Request)
18+
19+
Later, when the config is added, trigger a build:
20+
21+
``` sh
22+
gh workflow run -R compiler-explorer/infra 'Custom compiler build' -f image=gcc-cross -f version="arm64 14.2.0"
23+
```
24+
25+
Later, when the build is finished, add the needed config in `infra` repository. Test it with:
26+
27+
``` sh
28+
./bin/ce_install install compilers/c++/cross/gcc/arm 14.2.0
29+
```
30+
31+
When the compiler is installed, then you can update the config files using the
32+
instructions below. The script won't touch any config as it's a new target, but
33+
it will provide most of the content, ready to be copy/pasted all around.
34+
635
## How to add a new version for some/all cross compilers
736

837
The script [check_and_update_conf.py](./check_and_update_conf.py) can be used to automate some work:

0 commit comments

Comments
 (0)