Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(987)

Unified Diff: components/cronet/android/api/src/org/chromium/net/ExperimentalUrlRequest.java

Issue 2794823003: [Cronet] Better document Experimental Cronet classes (Closed)
Patch Set: address Andrei's comments Created 3 years, 8 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « components/cronet/android/api/src/org/chromium/net/ExperimentalCronetEngine.java ('k') | no next file » | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: components/cronet/android/api/src/org/chromium/net/ExperimentalUrlRequest.java
diff --git a/components/cronet/android/api/src/org/chromium/net/ExperimentalUrlRequest.java b/components/cronet/android/api/src/org/chromium/net/ExperimentalUrlRequest.java
index a74a1123491d09b50cd7dae6eff9acb06e87660c..11973efa7b04565b20378a3073865fe36904fc7e 100644
--- a/components/cronet/android/api/src/org/chromium/net/ExperimentalUrlRequest.java
+++ b/components/cronet/android/api/src/org/chromium/net/ExperimentalUrlRequest.java
@@ -6,17 +6,25 @@ package org.chromium.net;
import java.util.concurrent.Executor;
/**
- * {@link UrlRequest} that exposes experimental features. Created using
- * {@link ExperimentalUrlRequest.Builder}. Every instance of {@link UrlRequest} can
- * be casted to an instance of this class.
+ * {@link UrlRequest} that exposes experimental features. To obtain an
+ * instance of this class, cast a {@code UrlRequest} to this type. Every
+ * instance of {@code UrlRequest} can be cast to an instance of this class,
+ * as they are backed by the same implementation and hence perform identically.
+ * Instances of this class are not meant for general use, but instead only
+ * to access experimental features. Experimental features may be deprecated in the
+ * future. Use at your own risk.
*
* {@hide since this class exposes experimental features that should be hidden}.
*/
public abstract class ExperimentalUrlRequest extends UrlRequest {
/**
- * Builder for building {@link UrlRequest}. Created by
- * {@link ExperimentalCronetEngine#newUrlRequestBuilder}. A reference to this class
- * can also be obtained through downcasting of {@link UrlRequest.Builder}.
+ * {@link UrlRequest#Builder} that exposes experimental features. To obtain an
+ * instance of this class, cast a {@code UrlRequest.Builder} to this type. Every
+ * instance of {@code UrlRequest.Builder} can be cast to an instance of this class,
+ * as they are backed by the same implementation and hence perform identically.
+ * Instances of this class are not meant for general use, but instead only
+ * to access experimental features. Experimental features may be deprecated in the
+ * future. Use at your own risk.
*/
public abstract static class Builder extends UrlRequest.Builder {
/**
« no previous file with comments | « components/cronet/android/api/src/org/chromium/net/ExperimentalCronetEngine.java ('k') | no next file » | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698