From dd4906258dafa630acf54604642ab8b35117897b Mon Sep 17 00:00:00 2001
From: zzz <zzz@mail.i2p>
Date: Fri, 8 Jul 2011 13:47:49 +0000
Subject: [PATCH] javadoc
---
core/java/src/net/i2p/I2PAppContext.java | 21 +++++++++++++++++----
1 file changed, 17 insertions(+), 4 deletions(-)
diff --git a/core/java/src/net/i2p/I2PAppContext.java b/core/java/src/net/i2p/I2PAppContext.java
index b7ab613720..7e3a2e3116 100644
--- a/core/java/src/net/i2p/I2PAppContext.java
+++ b/core/java/src/net/i2p/I2PAppContext.java
@@ -148,23 +148,36 @@ public class I2PAppContext {
}
/**
- * Lets root a brand new context
- *
+ * Create a brand new context.
+ * WARNING: In almost all cases, you should use getGlobalContext() instead,
+ * to avoid creating additional contexts, which may spawn numerous
+ * additional resources and threads, and may be the cause of logging
+ * problems or hard-to-isolate bugs.
*/
public I2PAppContext() {
this(true, null);
}
/**
- * Lets root a brand new context
- *
+ * Create a brand new context.
+ * WARNING: In almost all cases, you should use getGlobalContext() instead,
+ * to avoid creating additional contexts, which may spawn numerous
+ * additional resources and threads, and may be the cause of logging
+ * problems or hard-to-isolate bugs.
*/
public I2PAppContext(Properties envProps) {
this(true, envProps);
}
/**
+ * Create a brand new context.
+ * WARNING: In almost all cases, you should use getGlobalContext() instead,
+ * to avoid creating additional contexts, which may spawn numerous
+ * additional resources and threads, and may be the cause of logging
+ * problems or hard-to-isolate bugs.
+ *
* @param doInit should this context be used as the global one (if necessary)?
+ * Will only apply if there is no global context now.
*/
private I2PAppContext(boolean doInit, Properties envProps) {
if (doInit) {
--
GitLab