fix: documentation for blob.update() and storage.update() methods is …

…confusing/incorrect
googleapis · Apr 16, 2020 · b97e5fe · b97e5fe
1 parent 9c56399
commit b97e5fe
Show file tree

Hide file tree

Showing 2 changed files with 5 additions and 5 deletions.
diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/Blob.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/Blob.java
@@ -546,9 +546,9 @@ public Blob reload(BlobSourceOption... options) {
   }
 
   /**
-   * Updates the blob properties. Optional {@code options} parameter specifies the preconditions for
-   * applying the update. To update the properties you need to call {@link #toBuilder()}, set the
-   * properties you want to change, build the new {@code Blob} instance and then call {@link
+   * Updates the blob properties. Optional {@code options} parameter can contain the preconditions
+   * for applying the update. To update the properties you need to call {@link #toBuilder()}, set
+   * the properties you want to change, build the new {@code Blob} instance and then call {@link
    * #update(BlobTargetOption...)}.
    *
    * <p>The property update details are described in {@link Storage#update(BlobInfo)}. {@link

diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/Storage.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/Storage.java
@@ -1992,8 +1992,8 @@ Blob create(
    * Updates the blob properties if the preconditions specified by {@code options} are met. The
    * property update works as described in {@link #update(BlobInfo)}.
    *
-   * <p>{@code options} parameter allows to specify the preconditions for applying the update. E.g.
-   * update of the blob properties might be required only if the properties have not been updated
+   * <p>{@code options} parameter can contain the preconditions for applying the update. E.g. update
+   * of the blob properties might be required only if the properties have not been updated
    * externally. {@code StorageException} with the code {@code 412} is thrown if preconditions fail.
    *
    * <p>Example of updating the content type only if the properties are not updated externally: