users_guide: More capabilities than processors considered harmful
authorBen Gamari <bgamari.foss@gmail.com>
Tue, 30 Aug 2016 21:05:25 +0000 (17:05 -0400)
committerBen Gamari <ben@smart-cactus.org>
Wed, 31 Aug 2016 17:15:33 +0000 (13:15 -0400)
Test Plan: None.

Reviewers: austin, simonmar

Reviewed By: simonmar

Subscribers: thomie

Differential Revision: https://phabricator.haskell.org/D2487

docs/users_guide/using-concurrent.rst

index 8c0587c..d62b811 100644 (file)
@@ -136,7 +136,8 @@ RTS ``-N`` options.
 
     Be careful when using all the processors in your machine: if some of
     your processors are in use by other programs, this can actually harm
-    performance rather than improve it.
+    performance rather than improve it. Asking GHC to create more capabilities
+    than you have physical threads is almost always a bad idea.
 
     Setting ``-N`` also has the effect of enabling the parallel garbage
     collector (see :ref:`rts-options-gc`).