updated docs for deprecation of featureextractor

Author: bmcfee

librosa/util/__init__.py

@@ -60,20 +60,12 @@
     find_files
 
 
-sklearn integration
--------------------
-
-.. autosummary::
-    :toctree: generated/
-
-    FeatureExtractor
-
-
 Deprecated
 ----------
 .. autosummary::
     :toctree: generated/
 
+    FeatureExtractor
     buf_to_int
 
 """

librosa/util/feature_extractor.py

@@ -14,6 +14,9 @@ class FeatureExtractor(BaseEstimator, TransformerMixin):
     This class acts as a bridge between feature extraction functions
     and scikit-learn pipelines.
 
+    .. warning:: The `FeatureExtractor` object is deprecated as of 0.4.2, and will be
+                 removed in 0.5.
+                 Instead, use ``sklearn.preprocessing.FunctionTransformer``.
 
     Attributes
     ----------
@@ -40,10 +43,6 @@ class FeatureExtractor(BaseEstimator, TransformerMixin):
     kwargs : additional keyword arguments
         Parameters to be passed through to `function`
 
-    .. note:: The `FeatureExtractor` object is deprecated as of 0.4.2, and will be
-              removed in 0.5.
-              Instead, use ``sklearn.preprocessing.FunctionTransformer``.
-
     Examples
     --------
     >>> import sklearn.pipeline