mirror of
https://github.com/dexoron/dcr.git
synced 2026-10-21 16:29:41 +00:00
Dexoron
617ba85442
- Toolchain overrides via `[toolchain]` and env (`DCR_*`) - ASM `.S` preprocessing via GCC/Clang (`-x assembler-with-cpp`)
45 lines
1.1 KiB
Markdown
45 lines
1.1 KiB
Markdown
# Build section
|
|
|
|
## Schema
|
|
|
|
```toml
|
|
[build]
|
|
language = "c"
|
|
standard = "c11"
|
|
compiler = "clang"
|
|
kind = "bin"
|
|
# optional:
|
|
# target = "./dist"
|
|
# platform = "x86_64"
|
|
# cflags = ["-Wall"]
|
|
# ldflags = ["-lm"]
|
|
```
|
|
|
|
## Fields
|
|
|
|
- `language` (string, required): `c`, `c++`, `cpp`, `cxx`, or `asm`.
|
|
- `standard` (string, required): language standard passed to compiler.
|
|
- `compiler` (string, required): compiler command (for example `clang`, `gcc`, `cl`).
|
|
- `kind` (string, required): `bin`, `staticlib`, or `sharedlib`.
|
|
- `target` (string, optional): custom output directory for final artifact.
|
|
- `platform` (string, optional): architecture hint for compiler (used for `-march` or `/arch`).
|
|
- `cflags` (string array, optional): extra compile flags.
|
|
- `ldflags` (string array, optional): extra link flags.
|
|
|
|
## Toolchain section
|
|
|
|
```toml
|
|
[toolchain]
|
|
cc = "clang"
|
|
cxx = "clang++"
|
|
as = "as"
|
|
ar = "ar"
|
|
ld = "ld"
|
|
```
|
|
|
|
## Behavior notes
|
|
|
|
- Compiler backend is selected by compiler string (`gcc`, `clang`, `cl`, `clang-cl`).
|
|
- Empty or unknown compiler value falls back to clang-like build path.
|
|
- `run` is not allowed for library kinds (`staticlib`, `sharedlib`).
|