update JavaDoc
diff --git a/bundles/org.eclipse.wst.sse.core/src/org/eclipse/wst/sse/core/internal/util/Utilities.java b/bundles/org.eclipse.wst.sse.core/src/org/eclipse/wst/sse/core/internal/util/Utilities.java index 16ed649..975100a 100644 --- a/bundles/org.eclipse.wst.sse.core/src/org/eclipse/wst/sse/core/internal/util/Utilities.java +++ b/bundles/org.eclipse.wst.sse.core/src/org/eclipse/wst/sse/core/internal/util/Utilities.java
@@ -96,7 +96,17 @@ } /** + * <p> * Ensures that an InputStream has mark/reset support. + * </p> + * <p> + * It's vital that a BufferedInputStream <b>not</b> be wrapped in another + * BufferedInputStream as each can preemptively consume <i>n</i> bytes + * (e.g. 2048) from the parent stream before any requests are made. The + * cascading effect is that the second/inner BufferedInputStream can never + * rewind itself to the first <i>n</i> bytes since they were already + * consumed by its parent. + * </p> */ public static InputStream getMarkSupportedStream(InputStream original) { if (original == null)