From 06acc5aab8052a45129d414c2ac42113edc8b468 Mon Sep 17 00:00:00 2001
From: Tony S Yu <tsyu80@gmail.com>
Date: Mon, 6 Feb 2012 23:50:59 -0500
Subject: [PATCH] DOC: Add description of subpackages to package docstring.

---
 skimage/__init__.py | 39 ++++++++++++++++++++++++++++++++++++++-
 1 file changed, 38 insertions(+), 1 deletion(-)

diff --git a/skimage/__init__.py b/skimage/__init__.py
index 4f543ad8..bd350fd9 100644
--- a/skimage/__init__.py
+++ b/skimage/__init__.py
@@ -1,5 +1,42 @@
-"""Image Processing SciKit (Toolbox for SciPy)"""
+"""Image Processing SciKit (Toolbox for SciPy)
 
+``scikits-image`` (a.k.a. ``skimage``) is a collection of algorithms for image
+processing and computer vision.
+
+The main package of ``skimage`` just provides a few utilities for converting
+between image data types; for most features, you'll need to import one of the
+subpackages described below:
+
+Subpackages
+-----------
+color
+    Utilities for converting between color spaces.
+data
+    Image data for testing and examples.
+draw
+    Functions for drawing on images.
+exposure
+    Utilities for adjusting the image intensity.
+feature
+    Functions for detecting features in images (e.g. texture, corners, etc.).
+filter
+    Image filters for denoising, sharpening, edge-finding, and more.
+graph
+    Functions based on graph-theoretic representations of images.
+io
+    Utilities for reading, saving, and displaying images and video.
+measure
+    Functions for image measurement.
+morphology
+    Mathematical morphology operations on images.
+segmentation
+    Algorithms segmenting images into regions.
+transform
+    Transform images into domains that are useful for detection and analysis.
+util
+    Utilities for image data-type conversion.
+
+"""
 
 import os.path as _osp