Repository navigation
Commit a93d4bf
committed
docs: configuration/construction/verification, runtime_search_dir, the prepare role and the stamp rule (mcpp#701, mcpp#702)
docs/30, and zh: a new section states the three kinds of work a build.mcpp
or the rules it imports do (SPEC-007 §1) -- configuration depends only on
declared inputs, construction is never done while build.mcpp runs, an
incomplete environment is a warning, and one behaviour serves planning and
building alike. `dep_bin` gains the paragraph on a host tool that fails to
build under `emit build-database`: naming it still configures correctly,
calling it while configuring does not. The directive tables and the typed
API table rename runtime-library-dir/runtime_library_dir to
runtime-search-dir/runtime_search_dir and correct what it joins; the worked
section is rewritten to match, with the Qt example fixed to pass `lib/` to
link_search and `bin/` to runtime_search_dir. The action role table gains
`prepare`, spelled with the `mcpp::roles` constants; a new section states
its contract (output_dir, the post-condition, the ordering, the R1.3
warning). The stamp-rule paragraph is rewritten for R2's simple form.
docs/31, and zh: the role table gains `prepare` and points at docs/30's
fuller contract and at SPEC-007.
docs/04, and zh §2.11: `runtime_search_dirs` (not the retiring
`library_dirs`) is named as the field the build-program form joins.1 parent 34f4da9 commit a93d4bf
6 files changed
Lines changed: 370 additions & 66 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1473 | 1473 | | |
1474 | 1474 | | |
1475 | 1475 | | |
1476 | | - | |
1477 | | - | |
1478 | | - | |
1479 | | - | |
| 1476 | + | |
| 1477 | + | |
| 1478 | + | |
| 1479 | + | |
| 1480 | + | |
| 1481 | + | |
| 1482 | + | |
1480 | 1483 | | |
1481 | 1484 | | |
1482 | 1485 | | |
| |||
0 commit comments