From 845b45a57ddb505ad7cbd50e7e3659ed37ed68be Mon Sep 17 00:00:00 2001
From: zzz <zzz@mail.i2p>
Date: Sat, 5 Jul 2014 13:36:29 +0000
Subject: [PATCH] javadoc
---
core/java/src/net/i2p/data/Hash.java | 8 ++++++++
1 file changed, 8 insertions(+)
diff --git a/core/java/src/net/i2p/data/Hash.java b/core/java/src/net/i2p/data/Hash.java
index 627f02c396..23d466d685 100644
--- a/core/java/src/net/i2p/data/Hash.java
+++ b/core/java/src/net/i2p/data/Hash.java
@@ -30,6 +30,14 @@ public class Hash extends SimpleDataStructure {
/**
* Pull from cache or return new
+ *
+ * WARNING - If the SDS is found in the cache, the passed-in
+ * byte array will be returned to the SimpleByteCache for reuse.
+ * Do NOT save a reference to the passed-in data, or use or modify it,
+ * after this call.
+ *
+ * Ignore this warning and you WILL corrupt the cache or other data structures.
+ *
* @throws IllegalArgumentException if data is not the correct number of bytes
* @since 0.8.3
*/
--
GitLab