LGTM with doc changes below. Should also add tests that we really don't post extra wide side effect updates, as we discussed.
http://gwt-code-reviews.appspot.com/958801/diff/1/2 File user/src/com/google/gwt/requestfactory/client/impl/AbstractRequestContext.java (right): http://gwt-code-reviews.appspot.com/958801/diff/1/2#newcode215 user/src/com/google/gwt/requestfactory/client/impl/AbstractRequestContext.java:215: * Apply the deltas in a ReturnRecord to an EntityProxy. deltas > snapshot Don't want the next guy to make the same mistaken assumption you did http://gwt-code-reviews.appspot.com/958801/show -- http://groups.google.com/group/Google-Web-Toolkit-Contributors