mirror of
https://github.com/dexoron/dcr.git
synced 2026-10-21 13:48:29 +00:00
64 lines
2.0 KiB
Plaintext
64 lines
2.0 KiB
Plaintext
---
|
|
sidebar_label: Introduction
|
|
---
|
|
|
|
# DCR — C/C++ Build Tool & Package Manager
|
|
|
|
<details>
|
|
<summary>Quick reference</summary>
|
|
|
|
```bash
|
|
# Installation
|
|
curl -fsSL https://dcr.dexoron.su/install.sh | sh
|
|
|
|
# Create a project
|
|
dcr new my-app
|
|
cd my-app
|
|
|
|
# Build and run
|
|
dcr build
|
|
dcr run
|
|
|
|
# Run tests
|
|
dcr test
|
|
|
|
# Add a dependency
|
|
dcr add fmt
|
|
|
|
# Generate IDE files
|
|
dcr gen vscode
|
|
```
|
|
|
|
</details>
|
|
|
|
## Contents
|
|
|
|
| Section | Description |
|
|
|---------|-------------|
|
|
| [Getting Started](/docs/getting-started/installation) | Installation and first steps |
|
|
| [Commands](/docs/commands/project-commands) | All CLI commands |
|
|
| [Reference](/docs/reference/dcr-toml) | Configuration, build, dependencies, platforms |
|
|
| [Testing](/docs/testing/test-framework) | Built-in test framework |
|
|
| [Recipes](/docs/recipes/cross-to-windows) | Common scenarios |
|
|
| [IDE Integration](/docs/ide-integration) | VS Code, CLion, compile_commands.json |
|
|
| [Self Update](/docs/self-update) | Auto-update |
|
|
| [FAQ](/docs/faq) | Frequently asked questions |
|
|
| [Changelog](/docs/changelog) | Version history |
|
|
| [License](/docs/license) | DCR and vendored library licenses |
|
|
| [Contributing](/docs/contributing) | DCR development |
|
|
|
|
## Features
|
|
|
|
- **Incremental builds** — mtime + `.d` headers + SHA256 fingerprint
|
|
- **Parallel compilation** — thread::scope, atomic task queue
|
|
- **4 backends** — gcc/clang, MSVC/clang-cl, GAS (ARM), NASM (x86)
|
|
- **7 project kinds** — bin, staticlib, sharedlib, efi, elf, none, custom
|
|
- **Cross-compilation** — short names and full triples
|
|
- **Profiles** — debug / release with field overrides
|
|
- **Workspaces** — multi-package projects with topological sort
|
|
- **Registry + Git + Path** — three dependency mechanisms
|
|
- **IDE generation** — VS Code, CLion, compile_commands.json, JSON metadata
|
|
- **pkg-config** — automatic system library discovery
|
|
- **Per-command `--help`** — `dcr build --help`, `dcr new --help`, etc.
|
|
- **Man pages** — `man dcr`, `man dcr-build`, `man dcr-new`
|