mirror of
https://github.com/dexoron/dcr.git
synced 2026-10-21 18:49:35 +00:00
Dexoron
210e82f026
- Custom build flags: `build.cflags` and `build.ldflags` - Recursive source discovery inside `src/` - Path dependencies with auto include/lib resolution and `dcr.lock` generation (experimental) - Add docs/index.md and docs/dcr-toml.md
42 lines
884 B
Markdown
42 lines
884 B
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"
|
|
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.
|