Document #236 under "Known issues" + addresss review comments

The explanation is taken from https://coq.zulipchat.com/#narrow/stream/240550-Dune-devs.20.26.20users/topic/dune.20and.20parallel.20builds. Also, if this is merged, please replace "jbuilder" by "dune" in the issue title, so that people who click the link aren't too confused. Signed-Off-By: Paolo G. Giarrusso <[email protected]>
ocaml · Jul 9, 2020 · d981e29 · d981e29
1 parent 7ac0a8b
commit d981e29
Showing 1 changed file with 8 additions and 0 deletions.
diff --git a/doc/known-issues.rst b/doc/known-issues.rst
@@ -15,3 +15,11 @@ https://github.com/ocaml/dune/issues/567
 So, while they are supported, you should be careful where you use them. Using a
 `.ml` only module is still preferable.
 
+parallel dune invocations on the same tree
+================
+
+One can invoke dune multiple times in parallel, as long as the invocations are not
+under the same root. That is to say, two dune runs cannot share the same target
+`_build` directory.
+
+This is tracked under https://github.com/ocaml/dune/issues/236.