From aaf6fca8239b72d1dcef4495164890840eaaec7f Mon Sep 17 00:00:00 2001
From: Dane Springmeyer <dane@dbsgeo.com>
Date: Mon, 30 Mar 2009 05:10:00 +0000
Subject: [PATCH] add docstring for Datasource wrapper

---
 bindings/python/mapnik/__init__.py | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/bindings/python/mapnik/__init__.py b/bindings/python/mapnik/__init__.py
index 51173e2f5..50cf899ec 100644
--- a/bindings/python/mapnik/__init__.py
+++ b/bindings/python/mapnik/__init__.py
@@ -95,7 +95,29 @@ class _Datasource(Datasource,_injector):
     def describe(self):
         return Describe(self)
 
+#class _Filter(Filter,_injector):
+#    """Mapnik Filter expression.
+#    
+#    Usage:
+#    >>> from mapnik import Filter
+#    >>> Filter("[waterway]='canal' and not ([tunnel] = 'yes' or [tunnel] ='true')")
+#    
+#    """
+
 def Datasource(**keywords):
+    """Wrapper around CreateDatasource.
+
+    Create a Mapnik Datasource using a dictionary of parameters.
+
+    Keywords must include:
+    
+      type='plugin_name' # e.g. type='gdal'
+    
+    See the convenience factory methods of each input plugin for
+    details on additional required keyword arguments.
+    
+    """
+
     return CreateDatasource(keywords)
 
 # convenience factory methods