feat: Update documentation with new sections for workspace guide, flags & environment, and troubleshooting map; enhance CLI reference and build/run notes for improved clarity.

This commit is contained in:
2026-03-21 14:15:06 +08:00
parent d08ceaf31d
commit cd5023243b
9 changed files with 191 additions and 8 deletions

View File

@@ -52,9 +52,9 @@ dcr build --debug --clean
## Notes
- The profile is selected from the first argument only.
- Profile flag (`--debug` / `--release`) can appear in any argument position (duplicates are rejected).
- Unknown profile flags return an error.
- Incremental rebuild is based on source/object mtime comparison.
- Incremental rebuild checks source/object mtime and tracked header dependencies.
- `--force` skips build cache checks and recompiles.
- `--clean` removes `target/<profile>` and `build.clean` paths before building.
- For `language = "asm"` with `compiler = "as"`/`"gas"`, use `.s` files (no preprocessing). For `.S`, use `gcc` or `clang`.