Add a few more explanatory comments to WebSearchProvider so it's clearer

in the open source what this package is for.

2 files changed, 7 insertions, 3 deletions

diff --git a/src/com/android/websearch/SuggestionProvider.java b/src/com/android/websearch/SuggestionProvider.java
index fddb7e3..edadc5b 100644
--- a/src/com/android/websearch/SuggestionProvider.java
+++ b/src/com/android/websearch/SuggestionProvider.java
@@ -49,9 +49,7 @@ import java.util.List;
 import java.util.Locale;
 
 /**
- * Use network-based Google Suggests to provide search suggestions.
- *
- * Future:  Merge live suggestions with saved recent queries
+ * Provides search suggestions, if any, for a given web search provider.
  */
 public class SuggestionProvider extends ContentProvider {
     private static final String USER_AGENT = "Android/1.0";
diff --git a/src/com/android/websearch/WebSearch.java b/src/com/android/websearch/WebSearch.java
index 04391ed..1b39382 100644
--- a/src/com/android/websearch/WebSearch.java
+++ b/src/com/android/websearch/WebSearch.java
@@ -27,6 +27,12 @@ import android.provider.Browser;
 import android.util.Log;
 
 /**
+ * WebSearchProvider is a package that exposes a set of different web search providers for the
+ * user to choose between which differ per locale. For those web search providers that have
+ * support for search suggestions as the user types, this package also exposes those suggestions.
+ * This package does not expose Google as a web search provider; that is done by the GoogleSearch
+ * and EnhancedGoogleSearchProvider packages.
+ * 
  * This class routes the web search intent action on web suggestion results to the browser and opens
  * up the appropriate search engine results page.
  */