diff options
author | Peter Collingbourne <peter@pcc.me.uk> | 2014-01-30 05:57:58 (GMT) |
---|---|---|
committer | Peter Collingbourne <peter@pcc.me.uk> | 2014-02-03 05:20:01 (GMT) |
commit | 2832613dc7c1a4a8ff3b9df729954715762a8381 (patch) | |
tree | 7f4be6edb18f26d73af002f977c2f4a901dfe2ea /doc | |
parent | 84986af6fdeae3f649f2bf884b20f644bc370e48 (diff) | |
download | Ninja-2832613dc7c1a4a8ff3b9df729954715762a8381.zip Ninja-2832613dc7c1a4a8ff3b9df729954715762a8381.tar.gz Ninja-2832613dc7c1a4a8ff3b9df729954715762a8381.tar.bz2 |
Introduce the "console" pool
This is a pre-defined pool with a depth of 1. It has the special property
that any task in the pool has direct access to the console. This can be
useful for interactive tasks or long-running tasks which produce status
updates on the console (such as test suites).
Diffstat (limited to 'doc')
-rw-r--r-- | doc/manual.asciidoc | 17 |
1 files changed, 17 insertions, 0 deletions
diff --git a/doc/manual.asciidoc b/doc/manual.asciidoc index 67fcbfd..5b0c1fe 100644 --- a/doc/manual.asciidoc +++ b/doc/manual.asciidoc @@ -648,6 +648,23 @@ build heavy_object2.obj: cc heavy_obj2.cc ---------------- +The `console` pool +^^^^^^^^^^^^^^^^^^ + +_Available since Ninja 1.5._ + +There exists a pre-defined pool named `console` with a depth of 1. It has +the special property that any task in the pool has direct access to the +standard input, output and error streams provided to Ninja, which are +normally connected to the user's console (hence the name) but could be +redirected. This can be useful for interactive tasks or long-running tasks +which produce status updates on the console (such as test suites). + +While a task in the `console` pool is running, Ninja's regular output (such +as progress status and output from concurrent tasks) is buffered until +it completes. + +This feature is not yet available on Windows. Ninja file reference -------------------- |