diff --git a/library/core/src/main/java/com/google/android/exoplayer2/upstream/DefaultHttpDataSource.java b/library/core/src/main/java/com/google/android/exoplayer2/upstream/DefaultHttpDataSource.java
index c5b3c0b08b..37329a4868 100644
--- a/library/core/src/main/java/com/google/android/exoplayer2/upstream/DefaultHttpDataSource.java
+++ b/library/core/src/main/java/com/google/android/exoplayer2/upstream/DefaultHttpDataSource.java
@@ -52,6 +52,10 @@ import java.util.zip.GZIPInputStream;
  * HTTP to HTTPS or vice versa). Cross-protocol redirects can be enabled by using the {@link
  * #DefaultHttpDataSource(String, Predicate, int, int, boolean, RequestProperties)} constructor and
  * passing {@code true} as the second last argument.
+ *
+ * <p>Note: HTTP request headers will be set using all parameters passed via (in order of decreasing
+ * priority) the {@code dataSpec}, {@link #setRequestProperty} and the default parameters used to
+ * construct the instance.
  */
 public class DefaultHttpDataSource extends BaseDataSource implements HttpDataSource {
 
@@ -265,10 +269,6 @@ public class DefaultHttpDataSource extends BaseDataSource implements HttpDataSou
 
   /**
    * Opens the source to read the specified data.
-   *
-   * <p>Note: HTTP request headers will be set using parameters passed via (in order of decreasing
-   * priority) the {@code dataSpec}, {@link #setRequestProperty} and the default parameters used to
-   * construct the instance.
    */
   @Override
   public long open(DataSpec dataSpec) throws HttpDataSourceException {