Implement feedback from @nh2 on docs

snoyberg · snoyberg · commit 4e6b24799d4d · 2018-06-20T18:34:31.000+03:00
diff --git a/ChangeLog.md b/ChangeLog.md
@@ -27,7 +27,7 @@ Other enhancements:
   the resulting tarball to the specified directory.
 * Introduced the `--interleaved-output` command line option and
   `build.interleaved-output` config value which causes multiple concurrent
-  builds to dump to stdout at the same time with a `packagename> ` prefix. See
+  builds to dump to stderr at the same time with a `packagename> ` prefix. See
   [#3225](https://github.com/commercialhaskell/stack/issues/3225).
 
 Bug fixes:
diff --git a/doc/build_command.md b/doc/build_command.md
@@ -194,3 +194,9 @@ end up in a log file instead of on the console unless it contains errors or
 warnings, to avoid problems of interleaved output and decrease console noise.
 If you would like to see this content instead, you can use the `--dump-logs`
 command line option, or add `dump-logs: all` to your `stack.yaml` file.
+
+Alternatively, starting with Stack 1.8, you can pass `--interleaved-output` to
+see output of all packages being built scroll by in a streaming fashion. The
+output from each package built will be prefixed by the package name, e.g. `mtl>
+Building ...`. Note that, unlike the default output, this will include the
+output from dependencies being built, not just targets.
