From 0f4e09500c9764d0ef1e1291d35a167eb5545c77 Mon Sep 17 00:00:00 2001
From: zzz <zzz@mail.i2p>
Date: Wed, 17 Jun 2015 23:46:11 +0000
Subject: [PATCH] javadocs
---
.../java/src/net/i2p/i2ptunnel/I2PTunnelHTTPClientRunner.java | 3 +++
.../router/networkdb/kademlia/FloodfillRouterInfoFloodJob.java | 1 +
.../net/i2p/router/networkdb/kademlia/FloodfillStoreJob.java | 2 ++
.../java/src/net/i2p/router/networkdb/kademlia/StoreJob.java | 2 ++
router/java/src/net/i2p/router/peermanager/PeerManager.java | 3 ++-
.../net/i2p/router/tunnel/pool/ExploratoryPeerSelector.java | 2 +-
6 files changed, 11 insertions(+), 2 deletions(-)
diff --git a/apps/i2ptunnel/java/src/net/i2p/i2ptunnel/I2PTunnelHTTPClientRunner.java b/apps/i2ptunnel/java/src/net/i2p/i2ptunnel/I2PTunnelHTTPClientRunner.java
index 51425cbd01..656b2c0f96 100644
--- a/apps/i2ptunnel/java/src/net/i2p/i2ptunnel/I2PTunnelHTTPClientRunner.java
+++ b/apps/i2ptunnel/java/src/net/i2p/i2ptunnel/I2PTunnelHTTPClientRunner.java
@@ -33,6 +33,9 @@ public class I2PTunnelHTTPClientRunner extends I2PTunnelRunner {
super(s, i2ps, slock, initialI2PData, null, sockList, onFail);
}
+ /**
+ * Only call once!
+ */
@Override
protected OutputStream getSocketOut() throws IOException {
OutputStream raw = super.getSocketOut();
diff --git a/router/java/src/net/i2p/router/networkdb/kademlia/FloodfillRouterInfoFloodJob.java b/router/java/src/net/i2p/router/networkdb/kademlia/FloodfillRouterInfoFloodJob.java
index fb620a1ad3..9ac4f73912 100644
--- a/router/java/src/net/i2p/router/networkdb/kademlia/FloodfillRouterInfoFloodJob.java
+++ b/router/java/src/net/i2p/router/networkdb/kademlia/FloodfillRouterInfoFloodJob.java
@@ -21,6 +21,7 @@ import net.i2p.util.Log;
* Also called when opting out of ff to call off the hounds ASAP.
* Currently floods FNDF.MAX_TO_FLOOD * 2 routers nearest to us.
*
+ * @since 0.9.21
*/
class FloodfillRouterInfoFloodJob extends JobImpl {
private final Log _log;
diff --git a/router/java/src/net/i2p/router/networkdb/kademlia/FloodfillStoreJob.java b/router/java/src/net/i2p/router/networkdb/kademlia/FloodfillStoreJob.java
index 5618d25645..b7ad0465fa 100644
--- a/router/java/src/net/i2p/router/networkdb/kademlia/FloodfillStoreJob.java
+++ b/router/java/src/net/i2p/router/networkdb/kademlia/FloodfillStoreJob.java
@@ -20,6 +20,8 @@ import net.i2p.util.Log;
/**
* This extends StoreJob to fire off a FloodfillVerifyStoreJob after success.
*
+ * Stores through this class always request a reply.
+ *
*/
class FloodfillStoreJob extends StoreJob {
private final FloodfillNetworkDatabaseFacade _facade;
diff --git a/router/java/src/net/i2p/router/networkdb/kademlia/StoreJob.java b/router/java/src/net/i2p/router/networkdb/kademlia/StoreJob.java
index 809b960154..2845de5614 100644
--- a/router/java/src/net/i2p/router/networkdb/kademlia/StoreJob.java
+++ b/router/java/src/net/i2p/router/networkdb/kademlia/StoreJob.java
@@ -33,6 +33,8 @@ import net.i2p.util.Log;
import net.i2p.util.VersionComparator;
/**
+ * Stores through this always request a reply.
+ *
* Unused directly - see FloodfillStoreJob
*/
class StoreJob extends JobImpl {
diff --git a/router/java/src/net/i2p/router/peermanager/PeerManager.java b/router/java/src/net/i2p/router/peermanager/PeerManager.java
index bb88fed790..8061a25177 100644
--- a/router/java/src/net/i2p/router/peermanager/PeerManager.java
+++ b/router/java/src/net/i2p/router/peermanager/PeerManager.java
@@ -193,7 +193,8 @@ class PeerManager {
}
/**
- * Find some peers that meet the criteria and we have the netDb info for locally
+ * Find some peers that meet the criteria and we have the netDb info for locally.
+ * Returned list will not include ourselves.
*
* Only used by PeerTestJob (PURPOSE_TEST)
*/
diff --git a/router/java/src/net/i2p/router/tunnel/pool/ExploratoryPeerSelector.java b/router/java/src/net/i2p/router/tunnel/pool/ExploratoryPeerSelector.java
index 68ad4e046f..6bb81fbc8c 100644
--- a/router/java/src/net/i2p/router/tunnel/pool/ExploratoryPeerSelector.java
+++ b/router/java/src/net/i2p/router/tunnel/pool/ExploratoryPeerSelector.java
@@ -24,7 +24,7 @@ class ExploratoryPeerSelector extends TunnelPeerSelector {
super(context);
}
- public List<Hash> selectPeers(TunnelPoolSettings settings) {
+ public List<Hash> selectPeers(TunnelPoolSettings settings) {
Log l = ctx.logManager().getLog(getClass());
int length = getLength(settings);
if (length < 0) {
--
GitLab