diff --git a/library/common/src/main/java/com/google/android/exoplayer2/upstream/DataSpec.java b/library/common/src/main/java/com/google/android/exoplayer2/upstream/DataSpec.java
index 395df63529..75e23ae6f2 100644
--- a/library/common/src/main/java/com/google/android/exoplayer2/upstream/DataSpec.java
+++ b/library/common/src/main/java/com/google/android/exoplayer2/upstream/DataSpec.java
@@ -518,7 +518,8 @@ public final class DataSpec {
    * set to {@link #HTTP_METHOD_POST}. If {@code postBody} is null then {@link #httpMethod} is set
    * to {@link #HTTP_METHOD_GET}.
    *
-   * @deprecated Use {@link Builder}.
+   * @deprecated Use {@link Builder}. Note that the httpMethod must be set explicitly for the
+   *     Builder.
    * @param uri {@link #uri}.
    * @param postBody {@link #httpBody} The body of the HTTP request, which is also used to infer the
    *     {@link #httpMethod}.