DOC Improve n_jobs docs in sklearn/multioutput.py
@@ -229,14 +229,17 @@ class MultiOutputRegressor(RegressorMixin, _MultiOutputEstimator):
An estimator object implementing :term:`fit` and :term:`predict`.
n_jobs : int or None, optional (default=None)
- The number of jobs to run in parallel for :meth:`fit`.
- ``None`` means 1 unless in a :obj:`joblib.parallel_backend` context.
- ``-1`` means using all processors. See :term:`Glossary <n_jobs>`
- for more details.
+ The number of jobs to run in parallel.
+ :meth:`fit`, :meth:`predict` and :meth:`partial_fit` (if supported
+ by the passed estimator) will be parallelized for each target.
+
+ When individual estimators are fast to train or predict,
+ using ``n_jobs > 1`` can result in slower performance due
+ to the parallelism overhead.
- When individual estimators are fast to train or predict
- using `n_jobs>1` can result in slower performance due
- to the overhead of spawning processes.
+ ``None`` means 1 unless in a :obj:`joblib.parallel_backend` context.
+ ``-1`` means using all available processes / threads.
+ See :term:`Glossary <n_jobs>` for more details.
.. versionchanged:: 0.20
`n_jobs` default changed from 1 to None
@@ -301,11 +304,17 @@ class MultiOutputClassifier(ClassifierMixin, _MultiOutputEstimator):
:term:`predict_proba`.
n_jobs : int or None, optional (default=None)
- The number of jobs to use for the computation.
- It does each target variable in y in parallel.
+ The number of jobs to run in parallel.
+ :meth:`fit`, :meth:`predict` and :meth:`partial_fit` (if supported
+ by the passed estimator) will be parallelized for each target.
+
+ When individual estimators are fast to train or predict,
+ using ``n_jobs > 1`` can result in slower performance due
+ to the parallelism overhead.
+
``None`` means 1 unless in a :obj:`joblib.parallel_backend` context.
- ``-1`` means using all processors. See :term:`Glossary <n_jobs>`
- for more details.
+ ``-1`` means using all available processes / threads.
+ See :term:`Glossary <n_jobs>` for more details.
.. versionchanged:: 0.20
`n_jobs` default changed from 1 to None
