From 5decf18eb5ca3f94c8ec199792f67b984662d312 Mon Sep 17 00:00:00 2001
From: zzz <zzz@mail.i2p>
Date: Fri, 29 Aug 2014 13:40:53 +0000
Subject: [PATCH] import, @since

---
 core/java/src/net/i2p/crypto/DSAEngine.java              | 9 +++++----
 core/java/src/net/i2p/crypto/eddsa/EdDSAEngine.java      | 1 +
 core/java/src/net/i2p/crypto/eddsa/EdDSAKey.java         | 2 ++
 core/java/src/net/i2p/crypto/eddsa/EdDSAPrivateKey.java  | 2 ++
 core/java/src/net/i2p/crypto/eddsa/EdDSAPublicKey.java   | 2 ++
 core/java/src/net/i2p/crypto/eddsa/KeyFactory.java       | 1 +
 core/java/src/net/i2p/crypto/eddsa/KeyPairGenerator.java | 2 ++
 core/java/src/net/i2p/crypto/eddsa/Utils.java            | 4 ++++
 core/java/src/net/i2p/crypto/eddsa/math/Curve.java       | 2 ++
 core/java/src/net/i2p/crypto/eddsa/math/Encoding.java    | 2 ++
 core/java/src/net/i2p/crypto/eddsa/math/Field.java       | 2 ++
 .../java/src/net/i2p/crypto/eddsa/math/FieldElement.java | 5 +++++
 .../java/src/net/i2p/crypto/eddsa/math/GroupElement.java | 2 ++
 core/java/src/net/i2p/crypto/eddsa/math/ScalarOps.java   | 5 +++++
 .../net/i2p/crypto/eddsa/spec/EdDSAGenParameterSpec.java | 2 ++
 .../net/i2p/crypto/eddsa/spec/EdDSANamedCurveSpec.java   | 2 ++
 .../net/i2p/crypto/eddsa/spec/EdDSANamedCurveTable.java  | 2 ++
 .../net/i2p/crypto/eddsa/spec/EdDSAParameterSpec.java    | 2 ++
 .../net/i2p/crypto/eddsa/spec/EdDSAPrivateKeySpec.java   | 2 ++
 .../net/i2p/crypto/eddsa/spec/EdDSAPublicKeySpec.java    | 2 ++
 20 files changed, 49 insertions(+), 4 deletions(-)

diff --git a/core/java/src/net/i2p/crypto/DSAEngine.java b/core/java/src/net/i2p/crypto/DSAEngine.java
index 8b0383b379..e4a8e67588 100644
--- a/core/java/src/net/i2p/crypto/DSAEngine.java
+++ b/core/java/src/net/i2p/crypto/DSAEngine.java
@@ -42,6 +42,7 @@ import java.security.interfaces.ECKey;
 import java.security.interfaces.RSAKey;
 
 import net.i2p.I2PAppContext;
+import net.i2p.crypto.eddsa.EdDSAEngine;
 import net.i2p.crypto.eddsa.EdDSAKey;
 import net.i2p.data.Hash;
 import net.i2p.data.Signature;
@@ -517,7 +518,7 @@ public class DSAEngine {
 
         java.security.Signature jsig;
         if (type.getBaseAlgorithm() == SigAlgo.EdDSA)
-            jsig = new net.i2p.crypto.eddsa.EdDSAEngine(type.getDigestInstance());
+            jsig = new EdDSAEngine(type.getDigestInstance());
         else
             jsig = java.security.Signature.getInstance(type.getAlgorithmName());
         PublicKey pubKey = SigUtil.toJavaKey(verifyingKey);
@@ -566,7 +567,7 @@ public class DSAEngine {
         String algo = getRawAlgo(type);
         java.security.Signature jsig;
         if (type.getBaseAlgorithm() == SigAlgo.EdDSA)
-            jsig = new net.i2p.crypto.eddsa.EdDSAEngine(); // Ignore algo, EdDSAKey includes a hash specification.
+            jsig = new EdDSAEngine(); // Ignore algo, EdDSAKey includes a hash specification.
         else
             jsig = java.security.Signature.getInstance(algo);
         jsig.initVerify(pubKey);
@@ -608,7 +609,7 @@ public class DSAEngine {
 
         java.security.Signature jsig;
         if (type.getBaseAlgorithm() == SigAlgo.EdDSA)
-            jsig = new net.i2p.crypto.eddsa.EdDSAEngine(type.getDigestInstance());
+            jsig = new EdDSAEngine(type.getDigestInstance());
         else
             jsig = java.security.Signature.getInstance(type.getAlgorithmName());
         PrivateKey privKey = SigUtil.toJavaKey(privateKey);
@@ -651,7 +652,7 @@ public class DSAEngine {
 
         java.security.Signature jsig;
         if (type.getBaseAlgorithm() == SigAlgo.EdDSA)
-            jsig = new net.i2p.crypto.eddsa.EdDSAEngine(); // Ignore algo, EdDSAKey includes a hash specification.
+            jsig = new EdDSAEngine(); // Ignore algo, EdDSAKey includes a hash specification.
         else
             jsig = java.security.Signature.getInstance(algo);
         jsig.initSign(privKey, _context.random());
diff --git a/core/java/src/net/i2p/crypto/eddsa/EdDSAEngine.java b/core/java/src/net/i2p/crypto/eddsa/EdDSAEngine.java
index a7c41fba37..6cf9b4d859 100644
--- a/core/java/src/net/i2p/crypto/eddsa/EdDSAEngine.java
+++ b/core/java/src/net/i2p/crypto/eddsa/EdDSAEngine.java
@@ -16,6 +16,7 @@ import net.i2p.crypto.eddsa.math.GroupElement;
 import net.i2p.crypto.eddsa.math.ScalarOps;
 
 /**
+ * @since 0.9.15
  * @author str4d
  *
  */
diff --git a/core/java/src/net/i2p/crypto/eddsa/EdDSAKey.java b/core/java/src/net/i2p/crypto/eddsa/EdDSAKey.java
index e093660f06..d710d8c2f6 100644
--- a/core/java/src/net/i2p/crypto/eddsa/EdDSAKey.java
+++ b/core/java/src/net/i2p/crypto/eddsa/EdDSAKey.java
@@ -4,6 +4,8 @@ import net.i2p.crypto.eddsa.spec.EdDSAParameterSpec;
 
 /**
  * Common interface for all EdDSA keys.
+ *
+ * @since 0.9.15
  * @author str4d
  *
  */
diff --git a/core/java/src/net/i2p/crypto/eddsa/EdDSAPrivateKey.java b/core/java/src/net/i2p/crypto/eddsa/EdDSAPrivateKey.java
index bbe7e1c6d3..d3945976aa 100644
--- a/core/java/src/net/i2p/crypto/eddsa/EdDSAPrivateKey.java
+++ b/core/java/src/net/i2p/crypto/eddsa/EdDSAPrivateKey.java
@@ -8,6 +8,8 @@ import net.i2p.crypto.eddsa.spec.EdDSAPrivateKeySpec;
 
 /**
  * An EdDSA private key.
+ *
+ * @since 0.9.15
  * @author str4d
  *
  */
diff --git a/core/java/src/net/i2p/crypto/eddsa/EdDSAPublicKey.java b/core/java/src/net/i2p/crypto/eddsa/EdDSAPublicKey.java
index e7505013ae..8e436bd1d8 100644
--- a/core/java/src/net/i2p/crypto/eddsa/EdDSAPublicKey.java
+++ b/core/java/src/net/i2p/crypto/eddsa/EdDSAPublicKey.java
@@ -8,6 +8,8 @@ import net.i2p.crypto.eddsa.spec.EdDSAPublicKeySpec;
 
 /**
  * An EdDSA public key.
+ *
+ * @since 0.9.15
  * @author str4d
  *
  */
diff --git a/core/java/src/net/i2p/crypto/eddsa/KeyFactory.java b/core/java/src/net/i2p/crypto/eddsa/KeyFactory.java
index e4daf36eb1..950130ac98 100644
--- a/core/java/src/net/i2p/crypto/eddsa/KeyFactory.java
+++ b/core/java/src/net/i2p/crypto/eddsa/KeyFactory.java
@@ -12,6 +12,7 @@ import net.i2p.crypto.eddsa.spec.EdDSAPrivateKeySpec;
 import net.i2p.crypto.eddsa.spec.EdDSAPublicKeySpec;
 
 /**
+ * @since 0.9.15
  * @author str4d
  *
  */
diff --git a/core/java/src/net/i2p/crypto/eddsa/KeyPairGenerator.java b/core/java/src/net/i2p/crypto/eddsa/KeyPairGenerator.java
index 81508f77c7..a3db1035ab 100644
--- a/core/java/src/net/i2p/crypto/eddsa/KeyPairGenerator.java
+++ b/core/java/src/net/i2p/crypto/eddsa/KeyPairGenerator.java
@@ -17,6 +17,8 @@ import net.i2p.crypto.eddsa.spec.EdDSAPublicKeySpec;
 
 /**
  *  Default strength is 256
+ *
+ *  @since 0.9.15
  */
 public class KeyPairGenerator extends KeyPairGeneratorSpi {
     private static final int DEFAULT_STRENGTH = 256;
diff --git a/core/java/src/net/i2p/crypto/eddsa/Utils.java b/core/java/src/net/i2p/crypto/eddsa/Utils.java
index 3d743f81bf..8c8bb2ea39 100644
--- a/core/java/src/net/i2p/crypto/eddsa/Utils.java
+++ b/core/java/src/net/i2p/crypto/eddsa/Utils.java
@@ -1,6 +1,10 @@
 package net.i2p.crypto.eddsa;
 
 /**
+ * Basic utilities for eddsa.
+ * Not for external use, not maintained as a public API.
+ *
+ * @since 0.9.15
  * @author str4d
  *
  */
diff --git a/core/java/src/net/i2p/crypto/eddsa/math/Curve.java b/core/java/src/net/i2p/crypto/eddsa/math/Curve.java
index 38f690e3fa..4cbc74757a 100644
--- a/core/java/src/net/i2p/crypto/eddsa/math/Curve.java
+++ b/core/java/src/net/i2p/crypto/eddsa/math/Curve.java
@@ -5,6 +5,8 @@ import java.io.Serializable;
 /**
  * A twisted Edwards curve.
  * Points on the curve satisfy -x^2 + y^2 = 1 + d x^2y^2
+ *
+ * @since 0.9.15
  * @author str4d
  *
  */
diff --git a/core/java/src/net/i2p/crypto/eddsa/math/Encoding.java b/core/java/src/net/i2p/crypto/eddsa/math/Encoding.java
index 4a3681fa77..932165beef 100644
--- a/core/java/src/net/i2p/crypto/eddsa/math/Encoding.java
+++ b/core/java/src/net/i2p/crypto/eddsa/math/Encoding.java
@@ -3,6 +3,8 @@ package net.i2p.crypto.eddsa.math;
 /**
  * Common interface for all (b-1)-bit encodings of elements
  * of EdDSA finite fields.
+ *
+ * @since 0.9.15
  * @author str4d
  *
  */
diff --git a/core/java/src/net/i2p/crypto/eddsa/math/Field.java b/core/java/src/net/i2p/crypto/eddsa/math/Field.java
index 040b3ffe01..ce89b78519 100644
--- a/core/java/src/net/i2p/crypto/eddsa/math/Field.java
+++ b/core/java/src/net/i2p/crypto/eddsa/math/Field.java
@@ -4,6 +4,8 @@ import java.io.Serializable;
 
 /**
  * An EdDSA finite field. Includes several pre-computed values.
+ *
+ * @since 0.9.15
  * @author str4d
  *
  */
diff --git a/core/java/src/net/i2p/crypto/eddsa/math/FieldElement.java b/core/java/src/net/i2p/crypto/eddsa/math/FieldElement.java
index a2b10b9f1c..4d9fc6a528 100644
--- a/core/java/src/net/i2p/crypto/eddsa/math/FieldElement.java
+++ b/core/java/src/net/i2p/crypto/eddsa/math/FieldElement.java
@@ -1,5 +1,10 @@
 package net.i2p.crypto.eddsa.math;
 
+/**
+ *
+ * @since 0.9.15
+ *
+ */
 public abstract class FieldElement {
     protected final Field f;
 
diff --git a/core/java/src/net/i2p/crypto/eddsa/math/GroupElement.java b/core/java/src/net/i2p/crypto/eddsa/math/GroupElement.java
index e8afdc90b9..1e416abe05 100644
--- a/core/java/src/net/i2p/crypto/eddsa/math/GroupElement.java
+++ b/core/java/src/net/i2p/crypto/eddsa/math/GroupElement.java
@@ -6,6 +6,8 @@ import net.i2p.crypto.eddsa.Utils;
 
 /**
  * A point (x,y) on an EdDSA curve.
+ *
+ * @since 0.9.15
  * @author str4d
  *
  */
diff --git a/core/java/src/net/i2p/crypto/eddsa/math/ScalarOps.java b/core/java/src/net/i2p/crypto/eddsa/math/ScalarOps.java
index 7073bd73fb..d90a80bcbe 100644
--- a/core/java/src/net/i2p/crypto/eddsa/math/ScalarOps.java
+++ b/core/java/src/net/i2p/crypto/eddsa/math/ScalarOps.java
@@ -1,5 +1,10 @@
 package net.i2p.crypto.eddsa.math;
 
+/**
+ *
+ * @since 0.9.15
+ *
+ */
 public interface ScalarOps {
     /**
      * Reduce the given scalar mod l.
diff --git a/core/java/src/net/i2p/crypto/eddsa/spec/EdDSAGenParameterSpec.java b/core/java/src/net/i2p/crypto/eddsa/spec/EdDSAGenParameterSpec.java
index 860bc5b9f8..2b3bfcd931 100644
--- a/core/java/src/net/i2p/crypto/eddsa/spec/EdDSAGenParameterSpec.java
+++ b/core/java/src/net/i2p/crypto/eddsa/spec/EdDSAGenParameterSpec.java
@@ -5,6 +5,8 @@ import java.security.spec.AlgorithmParameterSpec;
 /**
  * Implementation of AlgorithmParameterSpec that holds the name of a named
  * EdDSA curve specification.
+ *
+ * @since 0.9.15
  * @author str4d
  *
  */
diff --git a/core/java/src/net/i2p/crypto/eddsa/spec/EdDSANamedCurveSpec.java b/core/java/src/net/i2p/crypto/eddsa/spec/EdDSANamedCurveSpec.java
index f5d63c8418..e51f277389 100644
--- a/core/java/src/net/i2p/crypto/eddsa/spec/EdDSANamedCurveSpec.java
+++ b/core/java/src/net/i2p/crypto/eddsa/spec/EdDSANamedCurveSpec.java
@@ -6,6 +6,8 @@ import net.i2p.crypto.eddsa.math.ScalarOps;
 
 /**
  * EdDSA Curve specification that can also be referred to by name.
+ *
+ * @since 0.9.15
  * @author str4d
  *
  */
diff --git a/core/java/src/net/i2p/crypto/eddsa/spec/EdDSANamedCurveTable.java b/core/java/src/net/i2p/crypto/eddsa/spec/EdDSANamedCurveTable.java
index 076e2e660d..07fba43c33 100644
--- a/core/java/src/net/i2p/crypto/eddsa/spec/EdDSANamedCurveTable.java
+++ b/core/java/src/net/i2p/crypto/eddsa/spec/EdDSANamedCurveTable.java
@@ -10,6 +10,8 @@ import net.i2p.crypto.eddsa.math.ed25519.Ed25519ScalarOps;
 
 /**
  * The named EdDSA curves.
+ *
+ * @since 0.9.15
  * @author str4d
  *
  */
diff --git a/core/java/src/net/i2p/crypto/eddsa/spec/EdDSAParameterSpec.java b/core/java/src/net/i2p/crypto/eddsa/spec/EdDSAParameterSpec.java
index f24677476d..4ace0fb62c 100644
--- a/core/java/src/net/i2p/crypto/eddsa/spec/EdDSAParameterSpec.java
+++ b/core/java/src/net/i2p/crypto/eddsa/spec/EdDSAParameterSpec.java
@@ -12,6 +12,8 @@ import java.io.Serializable;
 
 /**
  * Parameter specification for an EdDSA algorithm.
+ *
+ * @since 0.9.15
  * @author str4d
  *
  */
diff --git a/core/java/src/net/i2p/crypto/eddsa/spec/EdDSAPrivateKeySpec.java b/core/java/src/net/i2p/crypto/eddsa/spec/EdDSAPrivateKeySpec.java
index f09585e56a..26f5c3a2d4 100644
--- a/core/java/src/net/i2p/crypto/eddsa/spec/EdDSAPrivateKeySpec.java
+++ b/core/java/src/net/i2p/crypto/eddsa/spec/EdDSAPrivateKeySpec.java
@@ -8,6 +8,8 @@ import java.util.Arrays;
 import net.i2p.crypto.eddsa.math.GroupElement;
 
 /**
+ *
+ * @since 0.9.15
  * @author str4d
  *
  */
diff --git a/core/java/src/net/i2p/crypto/eddsa/spec/EdDSAPublicKeySpec.java b/core/java/src/net/i2p/crypto/eddsa/spec/EdDSAPublicKeySpec.java
index 1a27edb718..0389260a0c 100644
--- a/core/java/src/net/i2p/crypto/eddsa/spec/EdDSAPublicKeySpec.java
+++ b/core/java/src/net/i2p/crypto/eddsa/spec/EdDSAPublicKeySpec.java
@@ -5,6 +5,8 @@ import java.security.spec.KeySpec;
 import net.i2p.crypto.eddsa.math.GroupElement;
 
 /**
+ *
+ * @since 0.9.15
  * @author str4d
  *
  */
-- 
GitLab