COSMIT: explainations of the partial import

sklearn/__init__.py

@@ -13,19 +13,24 @@
 See http://scikit-learn.sourceforge.net for complete documentation.
 """
 import sys
+__version__ = '0.12-git'
 
 try:
+    # This variable is injected in the __builtins__ by the build
+    # process. It used to enable importing subpackages of sklearn when
+    # the binaries are not built
     __SKLEARN_SETUP__
 except NameError:
     __SKLEARN_SETUP__ = False
 
 if __SKLEARN_SETUP__:
-    sys.stderr.write('Running from sklearn source directory.\n')
+    sys.stderr.write('Partial import of sklearn during the build process.\n')
+    # We are not importing the rest of the scikit during the build
+    # process, as it may not be compiled yet
 else:
     from . import __check_build
     from .base import clone
 
-
     try:
         from numpy.testing import nosetester
 
@@ -57,12 +62,10 @@ def test(self, label='fast', verbose=1, extra_argv=['--exe'],
     except:
         pass
 
-
     __all__ = ['cross_validation', 'cluster', 'covariance',
                'datasets', 'decomposition', 'feature_extraction',
                'feature_selection', 'semi_supervised',
                'gaussian_process', 'grid_search', 'hmm', 'lda', 'linear_model',
                'metrics', 'mixture', 'naive_bayes', 'neighbors', 'pipeline',
                'preprocessing', 'qda', 'svm', 'test', 'clone', 'pls']
 
-    __version__ = '0.12-git'