diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/markdown/snippets/custom_target_console_pool.md | 18 |
1 files changed, 9 insertions, 9 deletions
diff --git a/docs/markdown/snippets/custom_target_console_pool.md b/docs/markdown/snippets/custom_target_console_pool.md index 097b008..8b9bb34 100644 --- a/docs/markdown/snippets/custom_target_console_pool.md +++ b/docs/markdown/snippets/custom_target_console_pool.md @@ -1,13 +1,13 @@ ## New kwarg `console` for `custom_target()` -This keyword argument conflicts with `capture`, and is meant for commands -that are resource-intensive and take a long time to finish. With the Ninja -backend, setting this will add this target to [Ninja's `console` +This keyword argument conflicts with `capture`, and is meant for +commands that are resource-intensive and take a long time to +finish. With the Ninja backend, setting this will add this target to +[Ninja's `console` pool](https://ninja-build.org/manual.html#_the_literal_console_literal_pool), -which has special properties such as not buffering stdout and serializing all -targets in this pool. +which has special properties such as not buffering stdout and +serializing all targets in this pool. -The primary use-case for this is to be able to run external package managers -such as `cargo` to produce build artifacts. Without setting this, the user does -not receive any feedback about what the package manager is doing, which can -take a very long time to download and build packages. +The primary use-case for this is to be able to run external commands +that take a long time to exeute. Without setting this, the user does +not receive any feedback about what the program is doing. |