From dda7ae64af07fc54ee21f5802e999c50f4ec5309 Mon Sep 17 00:00:00 2001
From: Tim Su <tim@todoroo.com>
Date: Thu, 26 Aug 2010 01:44:39 -0700
Subject: [PATCH] Finished writing javadoc for content provider.

---
 .../astrid/provider/Astrid3ContentProvider.java     | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/astrid/src/com/todoroo/astrid/provider/Astrid3ContentProvider.java b/astrid/src/com/todoroo/astrid/provider/Astrid3ContentProvider.java
index ad646251c..dd6fd796f 100644
--- a/astrid/src/com/todoroo/astrid/provider/Astrid3ContentProvider.java
+++ b/astrid/src/com/todoroo/astrid/provider/Astrid3ContentProvider.java
@@ -27,6 +27,7 @@ import com.todoroo.astrid.dao.TaskDao;
 import com.todoroo.astrid.data.Metadata;
 import com.todoroo.astrid.data.StoreObject;
 import com.todoroo.astrid.data.Task;
+import com.todoroo.astrid.data.TaskApiDao;
 import com.todoroo.astrid.service.AstridDependencyInjector;
 
 /**
@@ -35,17 +36,23 @@ import com.todoroo.astrid.service.AstridDependencyInjector;
  * <li>access it directly just like any other content provider
  * <li>use the DAO classes from the Astrid API library
  * </ul>
- *
+ * <p>
  * The following base URI's are supported:
  * <ul>
  * <li>content://com.todoroo.astrid/tasks - task data ({@link Task})
  * <li>content://com.todoroo.astrid/metadata - task metadata ({@link Metadata})
  * <li>content://com.todoroo.astrid/store - non-task store data ({@link StoreObject})
  * </ul>
- *
+ * <p>
  * Each URI supports the following components:
  * <ul>
- * <li>/ - query for all items
+ * <li>/ - operate on all items (insert, delete, update, query)
+ * <li>/123 - operate on item id #123 (delete, update, query)
+ * <li>/groupby/title - query with SQL "group by" (query)
+ * </ul>
+ * <p>
+ * If you are writing a third-party application to access this data, you may
+ * also consider using one of the Api DAO objects like {@link TaskApiDao}.
  *
  * @author Tim Su <tim@todoroo.com>
  *