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

Unified Diff: components/cronet/android/api/src/org/chromium/net/ExperimentalBidirectionalStream.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 | « no previous file | components/cronet/android/api/src/org/chromium/net/ExperimentalCronetEngine.java » ('j') | 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/ExperimentalBidirectionalStream.java
diff --git a/components/cronet/android/api/src/org/chromium/net/ExperimentalBidirectionalStream.java b/components/cronet/android/api/src/org/chromium/net/ExperimentalBidirectionalStream.java
index 5be350c06bdf31772ead3b03d5c98fe647670f55..0a594e00db11fea4d02afb5824cb2ef54ec60c18 100644
--- a/components/cronet/android/api/src/org/chromium/net/ExperimentalBidirectionalStream.java
+++ b/components/cronet/android/api/src/org/chromium/net/ExperimentalBidirectionalStream.java
@@ -5,18 +5,25 @@
package org.chromium.net;
/**
- * {@link BidirectionalStream} that exposes experimental features.
- * Created using {@link Builder}. Every instance of {@link BidirectionalStream} can be casted
- * to an instance of this class.
+ * {@link BidirectionalStream} that exposes experimental features. To obtain an
+ * instance of this class, cast a {@code BidirectionalStream} to this type. Every
+ * instance of {@code BidirectionalStream} 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 prototype}
*/
public abstract class ExperimentalBidirectionalStream extends BidirectionalStream {
/**
- * Builder for {@link ExperimentalBidirectionalStream}s. Allows configuring stream before
- * constructing it via {@link Builder#build}. Created by
- * {@link ExperimentalCronetEngine#newBidirectionalStreamBuilder}. A reference to this class
- * can also be obtained through downcasting of {@link BidirectionalStream.Builder}.
+ * {@link BidirectionalStream#Builder} that exposes experimental features. To obtain an
+ * instance of this class, cast a {@code BidirectionalStream.Builder} to this type. Every
+ * instance of {@code BidirectionalStream.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 BidirectionalStream.Builder {
/**
« no previous file with comments | « no previous file | components/cronet/android/api/src/org/chromium/net/ExperimentalCronetEngine.java » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698