---

mziccard · mziccard · commit 11ffb2a6d1b4 · 2015-09-25T18:18:41.000+02:00
yaml --- r: 6151 b: refs/heads/tswast-patch-1 c: eb9ea81 h: refs/heads/master i: 6149: 99b1ec0 6147: 3a6af05 6143: b81efd6
diff --git a/[refs] b/[refs]
@@ -57,5 +57,5 @@ refs/tags/v0.18.0: 9d193c4c4b9d1c6f21515dd8e50836b9194ec9bb
 refs/tags/v0.19.0: e67b56e4d8dad5f9a7b38c9b2107c23c828f2ed5
 refs/tags/v0.20.0: 839f7fb7156535146aa1cb2c5aadd8d375d854e8
 refs/tags/v0.20.1: 370471f437f1f4f68a11e068df5cd6bf39edb1fa
-refs/heads/tswast-patch-1: 2e90926ac9042d6285704209eee1807ae273b2a8
+refs/heads/tswast-patch-1: eb9ea81f9e2aa52558db21642cff7fc656aa4316
 refs/heads/pubsub-streaming-pull: 19262b752ee874eb2ca3b950eb2aef44d5a5267b
diff --git a/branches/tswast-patch-1/gcloud-java-storage/src/main/java/com/google/gcloud/storage/Blob.java b/branches/tswast-patch-1/gcloud-java-storage/src/main/java/com/google/gcloud/storage/Blob.java
@@ -30,6 +30,12 @@
 
 /**
  * A Google cloud storage object.
+ *
+ * <p>
+ * Objects of this class are immutable. Operations that modify the blob like {@link #update} and
+ * {@link #copyTo} return a new object. To get a {@code Blob} object with the most recent
+ * information use {@link #reload}.
+ * </p>
  */
 public final class Blob {
 
@@ -151,7 +157,10 @@ public Blob reload(BlobSourceOption... options) {
   /**
    * Update the blob's information. Bucket or blob's name cannot be changed by this method. If you
    * want to rename the blob or move it to a different bucket use the {@link #copyTo} and
-   * {@link #delete} operations. A new {@code Blob} object is returned.
+   * {@link #delete} operations. A new {@code Blob} object is returned. By default no checks are
+   * made on the metadata generation of the current blob. If you want to update the information only
+   * if the current blob metadata are at their latest version use the {@code metagenerationMatch}
+   * option: {@code blob.update(newInfo, BlobTargetOption.metagenerationMatch()}.
    *
    * @param blobInfo new blob's information. Bucket and blob names must match the current ones
    * @param options update options
diff --git a/branches/tswast-patch-1/gcloud-java-storage/src/main/java/com/google/gcloud/storage/Bucket.java b/branches/tswast-patch-1/gcloud-java-storage/src/main/java/com/google/gcloud/storage/Bucket.java
@@ -31,6 +31,12 @@
 
 /**
  * A Google cloud storage bucket.
+ *
+ * <p>
+ * Objects of this class are immutable. Operations that modify the bucket like {@link #update}
+ * return a new object. To get a {@code Bucket} object with the most recent information use
+ * {@link #reload}.
+ * </p>
  */
 public final class Bucket {
 
@@ -91,7 +97,10 @@ public Bucket reload(BucketSourceOption... options) {
 
   /**
    * Update the bucket's information. Bucket's name cannot be changed. A new {@code Bucket} object
-   * is returned.
+   * is returned. By default no checks are made on the metadata generation of the current bucket.
+   * If you want to update the information only if the current bucket metadata are at their latest
+   * version use the {@code metagenerationMatch} option:
+   * {@code bucket.update(newInfo, BucketTargetOption.metagenerationMatch());}
    *
    * @param bucketInfo new bucket's information. Name must match the one of the current bucket
    * @param options update options
