mirror of
https://github.com/dexoron/dcr.git
synced 2026-10-21 09:58:35 +00:00
Dexoron
7817834790
- Incremental builds (object caching by mtime) - `build.kind` with `staticlib` support - Custom output directory via `build.target`
49 lines
1.0 KiB
Markdown
49 lines
1.0 KiB
Markdown
# DCR Documentation
|
|
|
|
DCR is a lightweight build tool for C/C++ projects with a Cargo-like workflow.
|
|
|
|
## Quick Start
|
|
|
|
```sh
|
|
dcr new hello
|
|
cd hello
|
|
dcr run
|
|
```
|
|
|
|
## Configuration
|
|
|
|
Project configuration lives in `dcr.toml`.
|
|
See `docs/dcr-toml.md` for the full schema and examples.
|
|
|
|
## Build Flags
|
|
|
|
You can add custom compile and link flags in `[build]`:
|
|
|
|
```toml
|
|
[build]
|
|
compiler = "gcc"
|
|
standard = "c99"
|
|
kind = "bin"
|
|
target = "./dist"
|
|
cflags = ["-D_POSIX_C_SOURCE=200809L", "-Wall", "-Wextra", "-O2", "-Ilib/frecli"]
|
|
ldflags = ["-Llib/frecli", "-lfrecli", "-lm"]
|
|
```
|
|
|
|
## Dependencies
|
|
|
|
Path dependencies can be declared in `[dependencies]` and are resolved on build.
|
|
|
|
```toml
|
|
[dependencies]
|
|
frecli = { path = "./lib/frecli", include = ["."], lib = ["."], libs = ["frecli"] }
|
|
```
|
|
|
|
## Source Discovery
|
|
|
|
DCR compiles all `.c`/`.cpp` files under `src/` recursively. The file containing `main()` can be in any subdirectory.
|
|
|
|
## Notes
|
|
|
|
- `dcr run` works only for `kind = "bin"`.
|
|
- Incremental rebuild currently tracks source file changes only (`.c/.cpp`).
|