DOC: updating GridSearchCV's n_jobs parameter

accraze · accraze · commit 5131d3ce0d42 · 2017-01-01T18:51:04.000-08:00
fixes #5797
diff --git a/sklearn/grid_search.py b/sklearn/grid_search.py
@@ -670,8 +670,17 @@ class GridSearchCV(BaseSearchCV):
     fit_params : dict, optional
         Parameters to pass to the fit method.
 
-    n_jobs : int, default=1
-        Number of jobs to run in parallel.
+    n_jobs: int, default: 1 :
+        The maximum number of estimators fit in parallel.
+
+            - If -1 all CPUs are used.
+
+            - If 1 is given, no parallel computing code is used at all,
+              which is useful for debugging.
+
+            - For n_jobs below -1, (n_cpus + 1 + n_jobs) are used.
+
+            - For n_jobs = -2, all CPUs but one are used.
 
         .. versionchanged:: 0.17
            Upgraded to joblib 0.9.3.
@@ -888,8 +897,17 @@ class RandomizedSearchCV(BaseSearchCV):
     fit_params : dict, optional
         Parameters to pass to the fit method.
 
-    n_jobs : int, default=1
-        Number of jobs to run in parallel.
+    n_jobs: int, default: 1 :
+        The maximum number of estimators fit in parallel.
+
+            - If -1 all CPUs are used.
+
+            - If 1 is given, no parallel computing code is used at all,
+              which is useful for debugging.
+
+            - For n_jobs below -1, (n_cpus + 1 + n_jobs) are used.
+
+            - For n_jobs = -2, all CPUs but one are used.
 
     pre_dispatch : int, or string, optional
         Controls the number of jobs that get dispatched during parallel
