This important comment should be part of the API docs.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/imaging/trunk@1749370 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/src/main/java/org/apache/commons/imaging/common/bytesource/ByteSource.java b/src/main/java/org/apache/commons/imaging/common/bytesource/ByteSource.java
index 2733db6..1968847 100644
--- a/src/main/java/org/apache/commons/imaging/common/bytesource/ByteSource.java
+++ b/src/main/java/org/apache/commons/imaging/common/bytesource/ByteSource.java
@@ -53,7 +53,7 @@
 
     public abstract byte[] getAll() throws IOException;
 
-    /*
+    /**
      * This operation can be VERY expensive; for inputstream byte sources, the
      * entire stream must be drained to determine its length.
      */