Merge pull request #607 from JuliaHomotopyContinuation/PBrdng-patch-1

Add comment that CPUs can hang when using multiple threads

Author: PBrdng

src/monodromy.jl

@@ -561,6 +561,8 @@ See also [`linear_subspace_homotopy`](@ref) for the `intrinsic` option.
 * `target_solutions_count`: The computation is stopped if this number of solutions is
   reached.
 * `threading = true`: Enable multithreading of the path tracking.
+  Careful: Some CPUs hang when using multiple threads. To avoid this run Julia with 1 
+  interactive thread for the REPL and `n` threads for other tasks (e.g., `julia -t 8,1` for `n=8`).
 * `timeout`: The maximal number of *seconds* the computation is allowed to run.
 * `trace_test = true`: If `true` a trace test is performed to check whether all solutions
   are found. This is only applicable if monodromy is performed with a linear subspace.

src/solve.jl

@@ -385,7 +385,9 @@ The `solve` routines takes the following options:
   for successfull paths. This is for example useful if you only want to compute one solution
   of a polynomial system. For this `stop_early_cb = _ -> true` would be sufficient.
 * `threading = true`: Enable multi-threading for the computation. The number of
-  available threads is controlled by the environment variable `JULIA_NUM_THREADS`.
+  available threads is controlled by the environment variable `JULIA_NUM_THREADS`. 
+  Careful: Some CPUs hang when using multiple threads. To avoid this run Julia with 1 
+  interactive thread for the REPL and `n` threads for other tasks (e.g., `julia -t 8,1` for `n=8`).
 * `tracker_options`: The options and parameters for the path tracker.
   See [`TrackerOptions`](@ref).