Added a warning to the javadoc of each src file and to package.html in the app, requestfactory, and valuestore modules.

Review at http://gwt-code-reviews.appspot.com/625801

Review by: rjrjr@google.com

git-svn-id: https://google-web-toolkit.googlecode.com/svn/trunk@8263 8db76d5a-ed1c-0410-87a9-c151d255dfc7
diff --git a/bikeshed/src/com/google/gwt/app/client/CellListPlacePickerView.java b/bikeshed/src/com/google/gwt/app/client/CellListPlacePickerView.java
index eec707b..5f455d2 100644
--- a/bikeshed/src/com/google/gwt/app/client/CellListPlacePickerView.java
+++ b/bikeshed/src/com/google/gwt/app/client/CellListPlacePickerView.java
@@ -28,6 +28,11 @@
 import java.util.List;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Hacky CellList based implementation of PlacePickerView, to be replaced by new
  * data widget, or at least something less ugly.
  * 
diff --git a/bikeshed/src/com/google/gwt/app/client/EditorSupport.java b/bikeshed/src/com/google/gwt/app/client/EditorSupport.java
index d843e20..7b3bbd0 100644
--- a/bikeshed/src/com/google/gwt/app/client/EditorSupport.java
+++ b/bikeshed/src/com/google/gwt/app/client/EditorSupport.java
@@ -23,6 +23,11 @@
 import java.util.Set;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Implemented by objects that provide data binding support for 
  * instances of {@link RecordEditView}. 
  * 
diff --git a/bikeshed/src/com/google/gwt/app/client/NotificationMole.java b/bikeshed/src/com/google/gwt/app/client/NotificationMole.java
index 4834618..9ba20f1 100644
--- a/bikeshed/src/com/google/gwt/app/client/NotificationMole.java
+++ b/bikeshed/src/com/google/gwt/app/client/NotificationMole.java
@@ -29,6 +29,11 @@
 import com.google.gwt.user.client.ui.HTMLPanel;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Simple widget for providing notification feedback.
  */
 public class NotificationMole extends Composite {
diff --git a/bikeshed/src/com/google/gwt/app/client/package.html b/bikeshed/src/com/google/gwt/app/client/package.html
index d424145..9f3bac1 100644
--- a/bikeshed/src/com/google/gwt/app/client/package.html
+++ b/bikeshed/src/com/google/gwt/app/client/package.html
@@ -1,5 +1,8 @@
 <html>
 <body>
 Client specific classes of the GWT application framework.
+
+<p><span style="color:red">Experimental API: All classes in this package are still under rapid development, and are very likely to be deleted or renamed. Use them at your own risk.
+</span></p>
 </body>
 </html>
diff --git a/bikeshed/src/com/google/gwt/app/package.html b/bikeshed/src/com/google/gwt/app/package.html
index 0b6c29d..c7deb8d 100644
--- a/bikeshed/src/com/google/gwt/app/package.html
+++ b/bikeshed/src/com/google/gwt/app/package.html
@@ -1,5 +1,9 @@
 <html>
 <body>
 Classes that frame an application architecture.
+
+<p><span style="color:red">Experimental API: All classes in this package are still under rapid development, and are very likely to be deleted or renamed. Use them at your own risk.
+</span></p>
+
 </body>
 </html>
diff --git a/bikeshed/src/com/google/gwt/app/place/AbstractActivity.java b/bikeshed/src/com/google/gwt/app/place/AbstractActivity.java
index 8ea5182..e474377 100644
--- a/bikeshed/src/com/google/gwt/app/place/AbstractActivity.java
+++ b/bikeshed/src/com/google/gwt/app/place/AbstractActivity.java
@@ -16,6 +16,11 @@
 package com.google.gwt.app.place;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Simple Activity implementation that is always willing to stop,
  * and does nothing onStop and onCancel.
  */
diff --git a/bikeshed/src/com/google/gwt/app/place/AbstractRecordEditActivity.java b/bikeshed/src/com/google/gwt/app/place/AbstractRecordEditActivity.java
index 4c69847..2dba31a 100644
--- a/bikeshed/src/com/google/gwt/app/place/AbstractRecordEditActivity.java
+++ b/bikeshed/src/com/google/gwt/app/place/AbstractRecordEditActivity.java
@@ -27,6 +27,11 @@
 import java.util.Set;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Abstract activity for editing a record.
  * 
  * @param <R> the type of Record being edited
diff --git a/bikeshed/src/com/google/gwt/app/place/AbstractRecordListActivity.java b/bikeshed/src/com/google/gwt/app/place/AbstractRecordListActivity.java
index 0b62591..10ae125 100644
--- a/bikeshed/src/com/google/gwt/app/place/AbstractRecordListActivity.java
+++ b/bikeshed/src/com/google/gwt/app/place/AbstractRecordListActivity.java
@@ -31,6 +31,11 @@
 import java.util.Map;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Abstract activity for requesting and displaying a list of {@Record}.
  * <p>
  * Subclasses must:
diff --git a/bikeshed/src/com/google/gwt/app/place/Activity.java b/bikeshed/src/com/google/gwt/app/place/Activity.java
index fb9115d..8bb212c 100644
--- a/bikeshed/src/com/google/gwt/app/place/Activity.java
+++ b/bikeshed/src/com/google/gwt/app/place/Activity.java
@@ -18,6 +18,11 @@
 import com.google.gwt.user.client.ui.IsWidget;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Implemented by objects that control a piece of user interface, with a life
  * cycle managed by an {@link ActivityManager}, in response to
  * {@link PlaceChangeEvent} events as the user navigates through the app.
diff --git a/bikeshed/src/com/google/gwt/app/place/ActivityManager.java b/bikeshed/src/com/google/gwt/app/place/ActivityManager.java
index 08635b6..75215ec 100644
--- a/bikeshed/src/com/google/gwt/app/place/ActivityManager.java
+++ b/bikeshed/src/com/google/gwt/app/place/ActivityManager.java
@@ -20,6 +20,11 @@
 import com.google.gwt.user.client.ui.IsWidget;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Manages {@link Activity} objects that should be kicked off in response to
  * {@link PlaceChangeEvent} events. Each activity can start itself
  * asynchronously, and provides a widget to be shown when it's ready to run.
diff --git a/bikeshed/src/com/google/gwt/app/place/ActivityMapper.java b/bikeshed/src/com/google/gwt/app/place/ActivityMapper.java
index 200959a..e35fbf4 100644
--- a/bikeshed/src/com/google/gwt/app/place/ActivityMapper.java
+++ b/bikeshed/src/com/google/gwt/app/place/ActivityMapper.java
@@ -16,6 +16,11 @@
 package com.google.gwt.app.place;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Finds the activity to run for a given {@link Place}, used to configure
  * an {@link ActivityManager}.
  * 
diff --git a/bikeshed/src/com/google/gwt/app/place/Place.java b/bikeshed/src/com/google/gwt/app/place/Place.java
index c315e38..59127fb 100644
--- a/bikeshed/src/com/google/gwt/app/place/Place.java
+++ b/bikeshed/src/com/google/gwt/app/place/Place.java
@@ -16,6 +16,11 @@
 package com.google.gwt.app.place;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Represents a bookmarkable location in an app. Implementations are expected to
  * provide correct {@link Object#equals(Object)} and {@link Object#hashCode()}
  * methods.
diff --git a/bikeshed/src/com/google/gwt/app/place/PlaceChangeEvent.java b/bikeshed/src/com/google/gwt/app/place/PlaceChangeEvent.java
index af8b2db..8d0658e 100644
--- a/bikeshed/src/com/google/gwt/app/place/PlaceChangeEvent.java
+++ b/bikeshed/src/com/google/gwt/app/place/PlaceChangeEvent.java
@@ -19,6 +19,11 @@
 import com.google.gwt.event.shared.GwtEvent;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Event thrown when the user has reached a new location in the app.
  * 
  * @param <P> the type of the new place
diff --git a/bikeshed/src/com/google/gwt/app/place/PlaceChangeRequestedEvent.java b/bikeshed/src/com/google/gwt/app/place/PlaceChangeRequestedEvent.java
index db68fb9..2f67328 100644
--- a/bikeshed/src/com/google/gwt/app/place/PlaceChangeRequestedEvent.java
+++ b/bikeshed/src/com/google/gwt/app/place/PlaceChangeRequestedEvent.java
@@ -19,6 +19,11 @@
 import com.google.gwt.event.shared.GwtEvent;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Event thrown when the user may go to a new place in the app. May be rejected.
  * 
  * @param <P> the type of the requested place
diff --git a/bikeshed/src/com/google/gwt/app/place/PlaceController.java b/bikeshed/src/com/google/gwt/app/place/PlaceController.java
index ddc15b7..f1c29cb 100644
--- a/bikeshed/src/com/google/gwt/app/place/PlaceController.java
+++ b/bikeshed/src/com/google/gwt/app/place/PlaceController.java
@@ -18,6 +18,11 @@
 import com.google.gwt.event.shared.HandlerManager;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * In charge of the user's location in the app.
  *
  * @param <P> the type of places managed
diff --git a/bikeshed/src/com/google/gwt/app/place/PlacePicker.java b/bikeshed/src/com/google/gwt/app/place/PlacePicker.java
index bc8396e..9984b99 100644
--- a/bikeshed/src/com/google/gwt/app/place/PlacePicker.java
+++ b/bikeshed/src/com/google/gwt/app/place/PlacePicker.java
@@ -20,6 +20,11 @@
 import java.util.List;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Presenter that goes to {@link Place}s the user picks.
  *
  * @param <P> the type of places listed
diff --git a/bikeshed/src/com/google/gwt/app/place/PlacePickerView.java b/bikeshed/src/com/google/gwt/app/place/PlacePickerView.java
index 1788485..cc70b2f 100644
--- a/bikeshed/src/com/google/gwt/app/place/PlacePickerView.java
+++ b/bikeshed/src/com/google/gwt/app/place/PlacePickerView.java
@@ -22,6 +22,11 @@
 import java.util.List;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * View for a {@link PlacePicker}.
  * 
  * @param <P> the type of place displayed
diff --git a/bikeshed/src/com/google/gwt/app/place/package.html b/bikeshed/src/com/google/gwt/app/place/package.html
index c4af633..f10479d 100644
--- a/bikeshed/src/com/google/gwt/app/place/package.html
+++ b/bikeshed/src/com/google/gwt/app/place/package.html
@@ -1,5 +1,7 @@
 <html>
 <body>
 Classes to define application workflow.
+<p><span style="color:red">Experimental API: All classes in this package are still under rapid development, and are very likely to be deleted or renamed. Use them at your own risk.
+</span></p>
 </body>
 </html>
diff --git a/bikeshed/src/com/google/gwt/app/rebind/EditorSupportGenerator.java b/bikeshed/src/com/google/gwt/app/rebind/EditorSupportGenerator.java
index 49d7837..80d6c0e 100644
--- a/bikeshed/src/com/google/gwt/app/rebind/EditorSupportGenerator.java
+++ b/bikeshed/src/com/google/gwt/app/rebind/EditorSupportGenerator.java
@@ -49,6 +49,11 @@
 import java.util.Map.Entry;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Generates implementations of {@link
  * com.google.gwt.app.client.EditorSupport EditorSupport} and its
  * nested interfaces.
diff --git a/bikeshed/src/com/google/gwt/app/rebind/package.html b/bikeshed/src/com/google/gwt/app/rebind/package.html
index 0e7dc90..9eb0788 100644
--- a/bikeshed/src/com/google/gwt/app/rebind/package.html
+++ b/bikeshed/src/com/google/gwt/app/rebind/package.html
@@ -1,5 +1,7 @@
 <html>
 <body>
 Code generators for the GWT application framework.
+<p><span style="color:red">Experimental API: All classes in this package are still under rapid development, and are very likely to be deleted or renamed. Use them at your own risk.
+</span></p>
 </body>
 </html>
diff --git a/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractDoubleRequest.java b/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractDoubleRequest.java
index 59891ba..18d6b4a 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractDoubleRequest.java
+++ b/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractDoubleRequest.java
@@ -16,6 +16,11 @@
 package com.google.gwt.requestfactory.client.impl;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Abstract implementation of
  * {@link com.google.gwt.requestfactory.shared.RequestFactory.RequestObject
  * RequestFactory.RequestObject} for requests that return Double.
diff --git a/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractIntegerRequest.java b/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractIntegerRequest.java
index ef499d3..b920f5c 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractIntegerRequest.java
+++ b/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractIntegerRequest.java
@@ -16,6 +16,11 @@
 package com.google.gwt.requestfactory.client.impl;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Abstract implementation of
  * {@link com.google.gwt.requestfactory.shared.RequestFactory.RequestObject
  * RequestFactory.RequestObject} for requests that return Integer.
diff --git a/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractJsonListRequest.java b/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractJsonListRequest.java
index 92e6d67..247fd40 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractJsonListRequest.java
+++ b/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractJsonListRequest.java
@@ -25,6 +25,11 @@
 import java.util.List;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Abstract implementation of
  * {@link com.google.gwt.requestfactory.shared.RequestFactory.RequestObject
  * RequestFactory.RequestObject} for requests that return lists of
diff --git a/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractJsonObjectRequest.java b/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractJsonObjectRequest.java
index 01b5d1c..f0cdbfd 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractJsonObjectRequest.java
+++ b/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractJsonObjectRequest.java
@@ -21,6 +21,11 @@
 import com.google.gwt.valuestore.shared.impl.RecordSchema;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Abstract implementation of
  * {@link com.google.gwt.requestfactory.shared.RequestFactory.RequestObject
  * RequestFactory.RequestObject} for requests that return single instances of
diff --git a/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractLongRequest.java b/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractLongRequest.java
index a3d7271..6ead442 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractLongRequest.java
+++ b/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractLongRequest.java
@@ -16,6 +16,11 @@
 package com.google.gwt.requestfactory.client.impl;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Abstract implementation of
  * {@link com.google.gwt.requestfactory.shared.RequestFactory.RequestObject
  * RequestFactory.RequestObject} for requests that return Long.
diff --git a/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractRequest.java b/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractRequest.java
index 60ce0f3..fbe42bf 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractRequest.java
+++ b/bikeshed/src/com/google/gwt/requestfactory/client/impl/AbstractRequest.java
@@ -25,6 +25,11 @@
 import java.util.Set;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Abstract implementation of {@link RequestFactory.RequestObject}.
  * 
  * @param <T> return type
diff --git a/bikeshed/src/com/google/gwt/requestfactory/client/impl/ClientRequestHelper.java b/bikeshed/src/com/google/gwt/requestfactory/client/impl/ClientRequestHelper.java
index 39f7fcc..0ee5ffc 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/client/impl/ClientRequestHelper.java
+++ b/bikeshed/src/com/google/gwt/requestfactory/client/impl/ClientRequestHelper.java
@@ -20,6 +20,11 @@
 import java.util.Map;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * A convenience class to convert a Map<String, String> to a JSON string on the
  * client side.
  */
diff --git a/bikeshed/src/com/google/gwt/requestfactory/client/impl/RequestFactoryJsonImpl.java b/bikeshed/src/com/google/gwt/requestfactory/client/impl/RequestFactoryJsonImpl.java
index 3770324..e7184d2 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/client/impl/RequestFactoryJsonImpl.java
+++ b/bikeshed/src/com/google/gwt/requestfactory/client/impl/RequestFactoryJsonImpl.java
@@ -37,6 +37,11 @@
 import java.util.Set;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Base implementation of RequestFactory.
  */
 public abstract class RequestFactoryJsonImpl implements RequestFactory {
diff --git a/bikeshed/src/com/google/gwt/requestfactory/rebind/RequestFactoryGenerator.java b/bikeshed/src/com/google/gwt/requestfactory/rebind/RequestFactoryGenerator.java
index fa9c95d..d8f1bc9 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/rebind/RequestFactoryGenerator.java
+++ b/bikeshed/src/com/google/gwt/requestfactory/rebind/RequestFactoryGenerator.java
@@ -58,6 +58,11 @@
 import java.util.Set;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Generates implementations of
  * {@link com.google.gwt.requestfactory.shared.RequestFactory RequestFactory}
  * and its nested interfaces.
diff --git a/bikeshed/src/com/google/gwt/requestfactory/server/RequestFactoryServlet.java b/bikeshed/src/com/google/gwt/requestfactory/server/RequestFactoryServlet.java
index efb67ec..43f20a8 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/server/RequestFactoryServlet.java
+++ b/bikeshed/src/com/google/gwt/requestfactory/server/RequestFactoryServlet.java
@@ -54,6 +54,11 @@
 import javax.validation.ValidatorFactory;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Handles GWT RequestFactory JSON requests. Configured via servlet context
  * param <code>servlet.serverOperation</code>, which must be set to the name of
  * a default instantiable class implementing
diff --git a/bikeshed/src/com/google/gwt/requestfactory/server/SampleDataPopulator.java b/bikeshed/src/com/google/gwt/requestfactory/server/SampleDataPopulator.java
index 4313330..c6709b0 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/server/SampleDataPopulator.java
+++ b/bikeshed/src/com/google/gwt/requestfactory/server/SampleDataPopulator.java
@@ -32,6 +32,11 @@
 import java.io.IOException;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Class to populate the datastore with sample data in a JSON file.
  */
 public class SampleDataPopulator {
diff --git a/bikeshed/src/com/google/gwt/requestfactory/server/package.html b/bikeshed/src/com/google/gwt/requestfactory/server/package.html
index 1104fe5..f650cc4 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/server/package.html
+++ b/bikeshed/src/com/google/gwt/requestfactory/server/package.html
@@ -3,5 +3,7 @@
 Server side classes for mediating between the client side and the persistent datastore.
 
 This package contains classes that can receive client side read and write requests in the JSON format, perform the necessary operations on the persistent datastore, and return the results in JSON format.
+<p><span style="color:red">Experimental API: All classes in this package are still under rapid development, and are very likely to be deleted or renamed. Use them at your own risk.
+</span></p>
 </body>
 </html>
diff --git a/bikeshed/src/com/google/gwt/requestfactory/shared/Id.java b/bikeshed/src/com/google/gwt/requestfactory/shared/Id.java
index 2f3dc36..58e7386 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/shared/Id.java
+++ b/bikeshed/src/com/google/gwt/requestfactory/shared/Id.java
@@ -16,6 +16,11 @@
 package com.google.gwt.requestfactory.shared;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Marks the id {@link com.google.gwt.valuestore.shared.Property Property} of an
  * {@link com.google.gwt.valuestore.shared.ValuesKey ValuesKey}.
  */
diff --git a/bikeshed/src/com/google/gwt/requestfactory/shared/Receiver.java b/bikeshed/src/com/google/gwt/requestfactory/shared/Receiver.java
index b6b3971..b24fdbd 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/shared/Receiver.java
+++ b/bikeshed/src/com/google/gwt/requestfactory/shared/Receiver.java
@@ -16,6 +16,11 @@
 package com.google.gwt.requestfactory.shared;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Implemented by objects that display values.
  *
  * @param <V> value type
diff --git a/bikeshed/src/com/google/gwt/requestfactory/shared/RecordListRequest.java b/bikeshed/src/com/google/gwt/requestfactory/shared/RecordListRequest.java
index f354eaf..69f659d 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/shared/RecordListRequest.java
+++ b/bikeshed/src/com/google/gwt/requestfactory/shared/RecordListRequest.java
@@ -22,6 +22,11 @@
 import java.util.List;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Implemented by RequestObjects for service methods that return lists of
  * records.
  * 
diff --git a/bikeshed/src/com/google/gwt/requestfactory/shared/RecordRequest.java b/bikeshed/src/com/google/gwt/requestfactory/shared/RecordRequest.java
index 0aa6475..7b1fea0 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/shared/RecordRequest.java
+++ b/bikeshed/src/com/google/gwt/requestfactory/shared/RecordRequest.java
@@ -21,6 +21,11 @@
 import java.util.Collection;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * A Request that returns specific properties for one or more {@link Record}
  * instances.
  * 
diff --git a/bikeshed/src/com/google/gwt/requestfactory/shared/RequestEvent.java b/bikeshed/src/com/google/gwt/requestfactory/shared/RequestEvent.java
index 164c91c..9751c65 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/shared/RequestEvent.java
+++ b/bikeshed/src/com/google/gwt/requestfactory/shared/RequestEvent.java
@@ -19,6 +19,11 @@
 import com.google.gwt.event.shared.GwtEvent;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * An event posted whenever an RPC request is sent or its response is received.
  */
 public class RequestEvent extends GwtEvent<RequestEvent.Handler> {
diff --git a/bikeshed/src/com/google/gwt/requestfactory/shared/RequestFactory.java b/bikeshed/src/com/google/gwt/requestfactory/shared/RequestFactory.java
index 9c3a880..8b81041 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/shared/RequestFactory.java
+++ b/bikeshed/src/com/google/gwt/requestfactory/shared/RequestFactory.java
@@ -24,6 +24,11 @@
 import java.util.Set;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Marker interface for the RequestFactory code generator.
  */
 public interface RequestFactory {
diff --git a/bikeshed/src/com/google/gwt/requestfactory/shared/ServerOperation.java b/bikeshed/src/com/google/gwt/requestfactory/shared/ServerOperation.java
index dcc8070..5ea31a3 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/shared/ServerOperation.java
+++ b/bikeshed/src/com/google/gwt/requestfactory/shared/ServerOperation.java
@@ -16,6 +16,11 @@
 package com.google.gwt.requestfactory.shared;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Annotation to mark RPC methods that specifies details about the operation to
  * be invoked on the server.
  */
diff --git a/bikeshed/src/com/google/gwt/requestfactory/shared/ServerType.java b/bikeshed/src/com/google/gwt/requestfactory/shared/ServerType.java
index e0f449c..f0df3c7 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/shared/ServerType.java
+++ b/bikeshed/src/com/google/gwt/requestfactory/shared/ServerType.java
@@ -21,6 +21,11 @@
 import java.lang.annotation.Target;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Annotation on Record classes specifying 'type'. 'type' represents the
  * server-side counterpart of the Record.
  */
diff --git a/bikeshed/src/com/google/gwt/requestfactory/shared/SyncRequest.java b/bikeshed/src/com/google/gwt/requestfactory/shared/SyncRequest.java
index 0e94395..a1012d5 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/shared/SyncRequest.java
+++ b/bikeshed/src/com/google/gwt/requestfactory/shared/SyncRequest.java
@@ -20,6 +20,11 @@
 import java.util.Set;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Request to commit CRUD operations accumulated in a DeltaValueStore.
  */
 // TODO this should merge with the main RequestObject
diff --git a/bikeshed/src/com/google/gwt/requestfactory/shared/Version.java b/bikeshed/src/com/google/gwt/requestfactory/shared/Version.java
index bbbae59..ebcabdd 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/shared/Version.java
+++ b/bikeshed/src/com/google/gwt/requestfactory/shared/Version.java
@@ -16,6 +16,11 @@
 package com.google.gwt.requestfactory.shared;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Marks the version {@link com.google.gwt.valuestore.shared.Property Property}
  * of an {@link com.google.gwt.valuestore.shared.ValuesKey ValuesKey}.
  */
diff --git a/bikeshed/src/com/google/gwt/requestfactory/shared/impl/RequestDataManager.java b/bikeshed/src/com/google/gwt/requestfactory/shared/impl/RequestDataManager.java
index 1e140e6..7af6641 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/shared/impl/RequestDataManager.java
+++ b/bikeshed/src/com/google/gwt/requestfactory/shared/impl/RequestDataManager.java
@@ -19,6 +19,11 @@
 import java.util.Map;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * An utility class to manage the encoding and decoding of parameters and
  * methodNames.
  * 
diff --git a/bikeshed/src/com/google/gwt/requestfactory/shared/package.html b/bikeshed/src/com/google/gwt/requestfactory/shared/package.html
index eb46119..a846a3f 100644
--- a/bikeshed/src/com/google/gwt/requestfactory/shared/package.html
+++ b/bikeshed/src/com/google/gwt/requestfactory/shared/package.html
@@ -1,5 +1,7 @@
 <html>
 <body>
 Shared classes used on both the client and the server side for transmitting data between the sever and the client in JSON format.
+<p><span style="color:red">Experimental API: All classes in this package are still under rapid development, and are very likely to be deleted or renamed. Use them at your own risk.
+</span></p>
 </body>
 </html>
diff --git a/bikeshed/src/com/google/gwt/valuestore/client/DeltaValueStoreJsonImpl.java b/bikeshed/src/com/google/gwt/valuestore/client/DeltaValueStoreJsonImpl.java
index d42bcee..30c6af8 100644
--- a/bikeshed/src/com/google/gwt/valuestore/client/DeltaValueStoreJsonImpl.java
+++ b/bikeshed/src/com/google/gwt/valuestore/client/DeltaValueStoreJsonImpl.java
@@ -33,6 +33,11 @@
 import java.util.Set;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * {@link DeltaValueStore} implementation based on {@link ValuesImpl}.
  */
 public class DeltaValueStoreJsonImpl implements DeltaValueStore {
diff --git a/bikeshed/src/com/google/gwt/valuestore/client/RecordKey.java b/bikeshed/src/com/google/gwt/valuestore/client/RecordKey.java
index 0f10975..c46e5b2 100644
--- a/bikeshed/src/com/google/gwt/valuestore/client/RecordKey.java
+++ b/bikeshed/src/com/google/gwt/valuestore/client/RecordKey.java
@@ -20,6 +20,11 @@
 import com.google.gwt.valuestore.shared.impl.RecordSchema;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * The key used to store {@link com.google.gwt.valuestore.shared.Record Record}s
  * in {@link com.google.gwt.valuestore.shared.ValueStore ValueStore}.
  */
diff --git a/bikeshed/src/com/google/gwt/valuestore/client/SyncResultImpl.java b/bikeshed/src/com/google/gwt/valuestore/client/SyncResultImpl.java
index c87c482..adb0b85 100644
--- a/bikeshed/src/com/google/gwt/valuestore/client/SyncResultImpl.java
+++ b/bikeshed/src/com/google/gwt/valuestore/client/SyncResultImpl.java
@@ -21,6 +21,11 @@
 import java.util.Map;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Concrete implementation of SyncResult.
  */
 public class SyncResultImpl implements SyncResult {
diff --git a/bikeshed/src/com/google/gwt/valuestore/client/ValueStoreJsonImpl.java b/bikeshed/src/com/google/gwt/valuestore/client/ValueStoreJsonImpl.java
index 3571e22..e7def3a 100644
--- a/bikeshed/src/com/google/gwt/valuestore/client/ValueStoreJsonImpl.java
+++ b/bikeshed/src/com/google/gwt/valuestore/client/ValueStoreJsonImpl.java
@@ -26,6 +26,11 @@
 import java.util.Map;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * {@link ValueStore} implementation based on {@link ValuesImpl}.
  */
 public class ValueStoreJsonImpl implements ValueStore {
diff --git a/bikeshed/src/com/google/gwt/valuestore/shared/DeltaValueStore.java b/bikeshed/src/com/google/gwt/valuestore/shared/DeltaValueStore.java
index 93b6ddf..d7df718 100644
--- a/bikeshed/src/com/google/gwt/valuestore/shared/DeltaValueStore.java
+++ b/bikeshed/src/com/google/gwt/valuestore/shared/DeltaValueStore.java
@@ -16,6 +16,11 @@
 package com.google.gwt.valuestore.shared;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Set of changes to a ValueStore.
  */
 public interface DeltaValueStore extends ValueStore {
diff --git a/bikeshed/src/com/google/gwt/valuestore/shared/Property.java b/bikeshed/src/com/google/gwt/valuestore/shared/Property.java
index 3b6945b..efa2288 100644
--- a/bikeshed/src/com/google/gwt/valuestore/shared/Property.java
+++ b/bikeshed/src/com/google/gwt/valuestore/shared/Property.java
@@ -16,6 +16,11 @@
 package com.google.gwt.valuestore.shared;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Defines a property of a {@link Record}.
  *
  * @param <V> the type of the property's value
diff --git a/bikeshed/src/com/google/gwt/valuestore/shared/PropertyReference.java b/bikeshed/src/com/google/gwt/valuestore/shared/PropertyReference.java
index 3166209..7eb2d7f 100644
--- a/bikeshed/src/com/google/gwt/valuestore/shared/PropertyReference.java
+++ b/bikeshed/src/com/google/gwt/valuestore/shared/PropertyReference.java
@@ -16,6 +16,11 @@
 package com.google.gwt.valuestore.shared;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * A pointer to a particular property value.
  *
  * @param <V> Value type
diff --git a/bikeshed/src/com/google/gwt/valuestore/shared/Record.java b/bikeshed/src/com/google/gwt/valuestore/shared/Record.java
index 72779fb..30ab962 100644
--- a/bikeshed/src/com/google/gwt/valuestore/shared/Record.java
+++ b/bikeshed/src/com/google/gwt/valuestore/shared/Record.java
@@ -16,6 +16,11 @@
 package com.google.gwt.valuestore.shared;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * An entry in a {@link com.google.gwt.valuestore.shared.ValueStore ValueStore}.
  */
 public interface Record {
diff --git a/bikeshed/src/com/google/gwt/valuestore/shared/RecordChangedEvent.java b/bikeshed/src/com/google/gwt/valuestore/shared/RecordChangedEvent.java
index 9d42d66..a71f1ef 100644
--- a/bikeshed/src/com/google/gwt/valuestore/shared/RecordChangedEvent.java
+++ b/bikeshed/src/com/google/gwt/valuestore/shared/RecordChangedEvent.java
@@ -19,6 +19,11 @@
 import com.google.gwt.event.shared.GwtEvent;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Abstract base class for an event announcing changes to a {@link Record}.
  * 
  * @param <R> the type of the record
diff --git a/bikeshed/src/com/google/gwt/valuestore/shared/SyncResult.java b/bikeshed/src/com/google/gwt/valuestore/shared/SyncResult.java
index e67bbcb..cadcbbf 100644
--- a/bikeshed/src/com/google/gwt/valuestore/shared/SyncResult.java
+++ b/bikeshed/src/com/google/gwt/valuestore/shared/SyncResult.java
@@ -15,10 +15,14 @@
  */
 package com.google.gwt.valuestore.shared;
 
-
 import java.util.Map;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Result per record of a SyncRequest.
  */
 public interface SyncResult {
diff --git a/bikeshed/src/com/google/gwt/valuestore/shared/Value.java b/bikeshed/src/com/google/gwt/valuestore/shared/Value.java
index 716f268..43f0912 100644
--- a/bikeshed/src/com/google/gwt/valuestore/shared/Value.java
+++ b/bikeshed/src/com/google/gwt/valuestore/shared/Value.java
@@ -16,6 +16,11 @@
 package com.google.gwt.valuestore.shared;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * @param <V> the type of the value
  */
 public class Value<V> extends PropertyReference<V> {
diff --git a/bikeshed/src/com/google/gwt/valuestore/shared/ValueStore.java b/bikeshed/src/com/google/gwt/valuestore/shared/ValueStore.java
index 3f4a485..e28180b 100644
--- a/bikeshed/src/com/google/gwt/valuestore/shared/ValueStore.java
+++ b/bikeshed/src/com/google/gwt/valuestore/shared/ValueStore.java
@@ -16,6 +16,11 @@
 package com.google.gwt.valuestore.shared;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * A store of records with properties. Each record has a {@link ValuesKey}
  * associated with it to indicate its type.
  */
diff --git a/bikeshed/src/com/google/gwt/valuestore/shared/WriteOperation.java b/bikeshed/src/com/google/gwt/valuestore/shared/WriteOperation.java
index 99c2edf..7ffda33 100644
--- a/bikeshed/src/com/google/gwt/valuestore/shared/WriteOperation.java
+++ b/bikeshed/src/com/google/gwt/valuestore/shared/WriteOperation.java
@@ -16,6 +16,11 @@
 package com.google.gwt.valuestore.shared;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * The write operation enum used in DeltaValueStore.
  */
 public enum WriteOperation {
diff --git a/bikeshed/src/com/google/gwt/valuestore/shared/impl/RecordImpl.java b/bikeshed/src/com/google/gwt/valuestore/shared/impl/RecordImpl.java
index 3c8f163..b1121d1 100644
--- a/bikeshed/src/com/google/gwt/valuestore/shared/impl/RecordImpl.java
+++ b/bikeshed/src/com/google/gwt/valuestore/shared/impl/RecordImpl.java
@@ -20,6 +20,11 @@
 import com.google.gwt.valuestore.shared.Record;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Base class for implementations of {@link Record}. It wraps a
  * {@link RecordJsoImpl} that does all the actual work. This class has little
  * reason to exist except to allow client code to make instanceof checks, and to
diff --git a/bikeshed/src/com/google/gwt/valuestore/shared/impl/RecordJsoImpl.java b/bikeshed/src/com/google/gwt/valuestore/shared/impl/RecordJsoImpl.java
index 9ed849f..7c313fa 100644
--- a/bikeshed/src/com/google/gwt/valuestore/shared/impl/RecordJsoImpl.java
+++ b/bikeshed/src/com/google/gwt/valuestore/shared/impl/RecordJsoImpl.java
@@ -25,6 +25,11 @@
 import java.util.Date;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * JSO implementation of {@link Record}, used to back subclasses of
  * {@link RecordImpl}.
  */
diff --git a/bikeshed/src/com/google/gwt/valuestore/shared/impl/RecordSchema.java b/bikeshed/src/com/google/gwt/valuestore/shared/impl/RecordSchema.java
index ec6a6a0..2f9d8c0 100644
--- a/bikeshed/src/com/google/gwt/valuestore/shared/impl/RecordSchema.java
+++ b/bikeshed/src/com/google/gwt/valuestore/shared/impl/RecordSchema.java
@@ -25,6 +25,11 @@
 import java.util.Set;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Used by {@link Record} implementations generated by
  * {@link com.google.gwt.requestfactory.rebind.RequestFactoryGenerator
  * RequestFactoryGenerator}. Defines the set of properties for a class of
diff --git a/bikeshed/src/com/google/gwt/valuestore/shared/impl/RecordToTypeMap.java b/bikeshed/src/com/google/gwt/valuestore/shared/impl/RecordToTypeMap.java
index 0fd7176..09b0c1d 100644
--- a/bikeshed/src/com/google/gwt/valuestore/shared/impl/RecordToTypeMap.java
+++ b/bikeshed/src/com/google/gwt/valuestore/shared/impl/RecordToTypeMap.java
@@ -18,6 +18,11 @@
 import com.google.gwt.valuestore.shared.Record;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * A class that can map the "TOKEN" generated by a JPA-savvy tool in every
  * Record class to its internal "type" representation.
  */
diff --git a/bikeshed/src/com/google/gwt/valuestore/shared/package.html b/bikeshed/src/com/google/gwt/valuestore/shared/package.html
index 6a1aded..dcf5035 100644
--- a/bikeshed/src/com/google/gwt/valuestore/shared/package.html
+++ b/bikeshed/src/com/google/gwt/valuestore/shared/package.html
@@ -1,5 +1,7 @@
 <html>
 <body>
 Client side classes for implementing ValueStore, a cache for storing a subset (or all) fields of server side objects.
+<p><span style="color:red">Experimental API: All classes in this package are still under rapid development, and are very likely to be deleted or renamed. Use them at your own risk.
+</span></p>
 </body>
 </html>
diff --git a/bikeshed/src/com/google/gwt/valuestore/ui/AbstractRecordListView.java b/bikeshed/src/com/google/gwt/valuestore/ui/AbstractRecordListView.java
index bfedcdd..07dc460 100644
--- a/bikeshed/src/com/google/gwt/valuestore/ui/AbstractRecordListView.java
+++ b/bikeshed/src/com/google/gwt/valuestore/ui/AbstractRecordListView.java
@@ -30,6 +30,11 @@
 import java.util.Set;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Abstract implementation of RecordListView. Subclasses must call {@link #init}
  * with the root widget, its {@link CellTable}, and a list of
  * {@link PropertyColumn}.
diff --git a/bikeshed/src/com/google/gwt/valuestore/ui/PropertyColumn.java b/bikeshed/src/com/google/gwt/valuestore/ui/PropertyColumn.java
index 2b3508d..c8b640f 100644
--- a/bikeshed/src/com/google/gwt/valuestore/ui/PropertyColumn.java
+++ b/bikeshed/src/com/google/gwt/valuestore/ui/PropertyColumn.java
@@ -22,6 +22,11 @@
 import com.google.gwt.valuestore.shared.Record;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * A column that displays a record property as a string.
  * 
  * @param <R> the type of record in this table
diff --git a/bikeshed/src/com/google/gwt/valuestore/ui/PropertyView.java b/bikeshed/src/com/google/gwt/valuestore/ui/PropertyView.java
index 5f7a44f..9828574 100644
--- a/bikeshed/src/com/google/gwt/valuestore/ui/PropertyView.java
+++ b/bikeshed/src/com/google/gwt/valuestore/ui/PropertyView.java
@@ -21,6 +21,11 @@
 import java.util.Set;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * A view that displays a set of {@link Property} values for a type of
  * {@link Record}.
  * 
diff --git a/bikeshed/src/com/google/gwt/valuestore/ui/RecordDetailsView.java b/bikeshed/src/com/google/gwt/valuestore/ui/RecordDetailsView.java
index 895594a..53194d4 100644
--- a/bikeshed/src/com/google/gwt/valuestore/ui/RecordDetailsView.java
+++ b/bikeshed/src/com/google/gwt/valuestore/ui/RecordDetailsView.java
@@ -19,6 +19,11 @@
 import com.google.gwt.user.client.ui.TakesValue;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Implemented by views that show the details of an object.
  *
  * @param <R> the type of object to show
diff --git a/bikeshed/src/com/google/gwt/valuestore/ui/RecordEditView.java b/bikeshed/src/com/google/gwt/valuestore/ui/RecordEditView.java
index c3a8a5b..7c442dd 100644
--- a/bikeshed/src/com/google/gwt/valuestore/ui/RecordEditView.java
+++ b/bikeshed/src/com/google/gwt/valuestore/ui/RecordEditView.java
@@ -23,6 +23,11 @@
 import java.util.Map;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * Implemented by views that edit {@link Record}s.
  * 
  * @param <R> the type of the record
diff --git a/bikeshed/src/com/google/gwt/valuestore/ui/RecordListView.java b/bikeshed/src/com/google/gwt/valuestore/ui/RecordListView.java
index e219a65..ca108f1 100644
--- a/bikeshed/src/com/google/gwt/valuestore/ui/RecordListView.java
+++ b/bikeshed/src/com/google/gwt/valuestore/ui/RecordListView.java
@@ -20,6 +20,11 @@
 import com.google.gwt.view.client.PagingListView;
 
 /**
+ * <p>
+ * <span style="color:red">Experimental API: This class is still under rapid
+ * development, and is very likely to be deleted. Use it at your own risk.
+ * </span>
+ * </p>
  * A view of a list of {@link Records}, which declares which properties it is
  * able to display.
  * <p>