8017326: Cleanup of the javadoc <code> tag in java.security.spec
Summary: Convert javadoc <code> and <tt> tags to {@code ...}
Reviewed-by: darcy
--- a/jdk/src/share/classes/java/security/spec/DSAGenParameterSpec.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/DSAGenParameterSpec.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2012, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2012, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -41,13 +41,13 @@
/**
* Creates a domain parameter specification for DSA parameter
- * generation using <code>primePLen</code> and <code>subprimeQLen</code>.
- * The value of <code>subprimeQLen</code> is also used as the default
+ * generation using {@code primePLen} and {@code subprimeQLen}.
+ * The value of {@code subprimeQLen} is also used as the default
* length of the domain parameter seed in bits.
* @param primePLen the desired length of the prime P in bits.
* @param subprimeQLen the desired length of the sub-prime Q in bits.
- * @exception IllegalArgumentException if <code>primePLen</code>
- * or <code>subprimeQLen</code> is illegal per the specification of
+ * @exception IllegalArgumentException if {@code primePLen}
+ * or {@code subprimeQLen} is illegal per the specification of
* FIPS 186-3.
*/
public DSAGenParameterSpec(int primePLen, int subprimeQLen) {
@@ -56,14 +56,14 @@
/**
* Creates a domain parameter specification for DSA parameter
- * generation using <code>primePLen</code>, <code>subprimeQLen</code>,
- * and <code>seedLen</code>.
+ * generation using {@code primePLen}, {@code subprimeQLen},
+ * and {@code seedLen}.
* @param primePLen the desired length of the prime P in bits.
* @param subprimeQLen the desired length of the sub-prime Q in bits.
* @param seedLen the desired length of the domain parameter seed in bits,
- * shall be equal to or greater than <code>subprimeQLen</code>.
- * @exception IllegalArgumentException if <code>primePLenLen</code>,
- * <code>subprimeQLen</code>, or <code>seedLen</code> is illegal per the
+ * shall be equal to or greater than {@code subprimeQLen}.
+ * @exception IllegalArgumentException if {@code primePLenLen},
+ * {@code subprimeQLen}, or {@code seedLen} is illegal per the
* specification of FIPS 186-3.
*/
public DSAGenParameterSpec(int primePLen, int subprimeQLen, int seedLen) {
--- a/jdk/src/share/classes/java/security/spec/DSAParameterSpec.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/DSAParameterSpec.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1997, 1999, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -61,27 +61,27 @@
}
/**
- * Returns the prime <code>p</code>.
+ * Returns the prime {@code p}.
*
- * @return the prime <code>p</code>.
+ * @return the prime {@code p}.
*/
public BigInteger getP() {
return this.p;
}
/**
- * Returns the sub-prime <code>q</code>.
+ * Returns the sub-prime {@code q}.
*
- * @return the sub-prime <code>q</code>.
+ * @return the sub-prime {@code q}.
*/
public BigInteger getQ() {
return this.q;
}
/**
- * Returns the base <code>g</code>.
+ * Returns the base {@code g}.
*
- * @return the base <code>g</code>.
+ * @return the base {@code g}.
*/
public BigInteger getG() {
return this.g;
--- a/jdk/src/share/classes/java/security/spec/DSAPrivateKeySpec.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/DSAPrivateKeySpec.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1997, 1999, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -69,36 +69,36 @@
}
/**
- * Returns the private key <code>x</code>.
+ * Returns the private key {@code x}.
*
- * @return the private key <code>x</code>.
+ * @return the private key {@code x}.
*/
public BigInteger getX() {
return this.x;
}
/**
- * Returns the prime <code>p</code>.
+ * Returns the prime {@code p}.
*
- * @return the prime <code>p</code>.
+ * @return the prime {@code p}.
*/
public BigInteger getP() {
return this.p;
}
/**
- * Returns the sub-prime <code>q</code>.
+ * Returns the sub-prime {@code q}.
*
- * @return the sub-prime <code>q</code>.
+ * @return the sub-prime {@code q}.
*/
public BigInteger getQ() {
return this.q;
}
/**
- * Returns the base <code>g</code>.
+ * Returns the base {@code g}.
*
- * @return the base <code>g</code>.
+ * @return the base {@code g}.
*/
public BigInteger getG() {
return this.g;
--- a/jdk/src/share/classes/java/security/spec/DSAPublicKeySpec.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/DSAPublicKeySpec.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1997, 1999, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -69,36 +69,36 @@
}
/**
- * Returns the public key <code>y</code>.
+ * Returns the public key {@code y}.
*
- * @return the public key <code>y</code>.
+ * @return the public key {@code y}.
*/
public BigInteger getY() {
return this.y;
}
/**
- * Returns the prime <code>p</code>.
+ * Returns the prime {@code p}.
*
- * @return the prime <code>p</code>.
+ * @return the prime {@code p}.
*/
public BigInteger getP() {
return this.p;
}
/**
- * Returns the sub-prime <code>q</code>.
+ * Returns the sub-prime {@code q}.
*
- * @return the sub-prime <code>q</code>.
+ * @return the sub-prime {@code q}.
*/
public BigInteger getQ() {
return this.q;
}
/**
- * Returns the base <code>g</code>.
+ * Returns the base {@code g}.
*
- * @return the base <code>g</code>.
+ * @return the base {@code g}.
*/
public BigInteger getG() {
return this.g;
--- a/jdk/src/share/classes/java/security/spec/ECFieldF2m.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/ECFieldF2m.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2003, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -45,9 +45,9 @@
/**
* Creates an elliptic curve characteristic 2 finite
- * field which has 2^<code>m</code> elements with normal basis.
- * @param m with 2^<code>m</code> being the number of elements.
- * @exception IllegalArgumentException if <code>m</code>
+ * field which has 2^{@code m} elements with normal basis.
+ * @param m with 2^{@code m} being the number of elements.
+ * @exception IllegalArgumentException if {@code m}
* is not positive.
*/
public ECFieldF2m(int m) {
@@ -61,24 +61,24 @@
/**
* Creates an elliptic curve characteristic 2 finite
- * field which has 2^<code>m</code> elements with
+ * field which has 2^{@code m} elements with
* polynomial basis.
* The reduction polynomial for this field is based
- * on <code>rp</code> whose i-th bit correspondes to
+ * on {@code rp} whose i-th bit correspondes to
* the i-th coefficient of the reduction polynomial.<p>
* Note: A valid reduction polynomial is either a
- * trinomial (X^<code>m</code> + X^<code>k</code> + 1
- * with <code>m</code> > <code>k</code> >= 1) or a
- * pentanomial (X^<code>m</code> + X^<code>k3</code>
- * + X^<code>k2</code> + X^<code>k1</code> + 1 with
- * <code>m</code> > <code>k3</code> > <code>k2</code>
- * > <code>k1</code> >= 1).
- * @param m with 2^<code>m</code> being the number of elements.
+ * trinomial (X^{@code m} + X^{@code k} + 1
+ * with {@code m} > {@code k} >= 1) or a
+ * pentanomial (X^{@code m} + X^{@code k3}
+ * + X^{@code k2} + X^{@code k1} + 1 with
+ * {@code m} > {@code k3} > {@code k2}
+ * > {@code k1} >= 1).
+ * @param m with 2^{@code m} being the number of elements.
* @param rp the BigInteger whose i-th bit corresponds to
* the i-th coefficient of the reduction polynomial.
- * @exception NullPointerException if <code>rp</code> is null.
- * @exception IllegalArgumentException if <code>m</code>
- * is not positive, or <code>rp</code> does not represent
+ * @exception NullPointerException if {@code rp} is null.
+ * @exception IllegalArgumentException if {@code m}
+ * is not positive, or {@code rp} does not represent
* a valid reduction polynomial.
*/
public ECFieldF2m(int m, BigInteger rp) {
@@ -106,28 +106,28 @@
/**
* Creates an elliptic curve characteristic 2 finite
- * field which has 2^<code>m</code> elements with
+ * field which has 2^{@code m} elements with
* polynomial basis. The reduction polynomial for this
- * field is based on <code>ks</code> whose content
+ * field is based on {@code ks} whose content
* contains the order of the middle term(s) of the
* reduction polynomial.
* Note: A valid reduction polynomial is either a
- * trinomial (X^<code>m</code> + X^<code>k</code> + 1
- * with <code>m</code> > <code>k</code> >= 1) or a
- * pentanomial (X^<code>m</code> + X^<code>k3</code>
- * + X^<code>k2</code> + X^<code>k1</code> + 1 with
- * <code>m</code> > <code>k3</code> > <code>k2</code>
- * > <code>k1</code> >= 1), so <code>ks</code> should
+ * trinomial (X^{@code m} + X^{@code k} + 1
+ * with {@code m} > {@code k} >= 1) or a
+ * pentanomial (X^{@code m} + X^{@code k3}
+ * + X^{@code k2} + X^{@code k1} + 1 with
+ * {@code m} > {@code k3} > {@code k2}
+ * > {@code k1} >= 1), so {@code ks} should
* have length 1 or 3.
- * @param m with 2^<code>m</code> being the number of elements.
+ * @param m with 2^{@code m} being the number of elements.
* @param ks the order of the middle term(s) of the
* reduction polynomial. Contents of this array are copied
* to protect against subsequent modification.
- * @exception NullPointerException if <code>ks</code> is null.
- * @exception IllegalArgumentException if<code>m</code>
- * is not positive, or the length of <code>ks</code>
- * is neither 1 nor 3, or values in <code>ks</code>
- * are not between <code>m</code>-1 and 1 (inclusive)
+ * @exception NullPointerException if {@code ks} is null.
+ * @exception IllegalArgumentException if{@code m}
+ * is not positive, or the length of {@code ks}
+ * is neither 1 nor 3, or values in {@code ks}
+ * are not between {@code m}-1 and 1 (inclusive)
* and in descending order.
*/
public ECFieldF2m(int m, int[] ks) {
@@ -160,7 +160,7 @@
}
/**
- * Returns the field size in bits which is <code>m</code>
+ * Returns the field size in bits which is {@code m}
* for this characteristic 2 finite field.
* @return the field size in bits.
*/
@@ -169,9 +169,9 @@
}
/**
- * Returns the value <code>m</code> of this characteristic
+ * Returns the value {@code m} of this characteristic
* 2 finite field.
- * @return <code>m</code> with 2^<code>m</code> being the
+ * @return {@code m} with 2^{@code m} being the
* number of elements.
*/
public int getM() {
@@ -211,8 +211,8 @@
* Compares this finite field for equality with the
* specified object.
* @param obj the object to be compared.
- * @return true if <code>obj</code> is an instance
- * of ECFieldF2m and both <code>m</code> and the reduction
+ * @return true if {@code obj} is an instance
+ * of ECFieldF2m and both {@code m} and the reduction
* polynomial match, false otherwise.
*/
public boolean equals(Object obj) {
--- a/jdk/src/share/classes/java/security/spec/ECFieldFp.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/ECFieldFp.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2003, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -43,10 +43,10 @@
/**
* Creates an elliptic curve prime finite field
- * with the specified prime <code>p</code>.
+ * with the specified prime {@code p}.
* @param p the prime.
- * @exception NullPointerException if <code>p</code> is null.
- * @exception IllegalArgumentException if <code>p</code>
+ * @exception NullPointerException if {@code p} is null.
+ * @exception IllegalArgumentException if {@code p}
* is not positive.
*/
public ECFieldFp(BigInteger p) {
@@ -66,7 +66,7 @@
};
/**
- * Returns the prime <code>p</code> of this prime finite field.
+ * Returns the prime {@code p} of this prime finite field.
* @return the prime.
*/
public BigInteger getP() {
@@ -77,7 +77,7 @@
* Compares this prime finite field for equality with the
* specified object.
* @param obj the object to be compared.
- * @return true if <code>obj</code> is an instance
+ * @return true if {@code obj} is an instance
* of ECFieldFp and the prime value match, false otherwise.
*/
public boolean equals(Object obj) {
--- a/jdk/src/share/classes/java/security/spec/ECGenParameterSpec.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/ECGenParameterSpec.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2003, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -41,13 +41,13 @@
/**
* Creates a parameter specification for EC parameter
* generation using a standard (or predefined) name
- * <code>stdName</code> in order to generate the corresponding
+ * {@code stdName} in order to generate the corresponding
* (precomputed) elliptic curve domain parameters. For the
* list of supported names, please consult the documentation
* of provider whose implementation will be used.
* @param stdName the standard name of the to-be-generated EC
* domain parameters.
- * @exception NullPointerException if <code>stdName</code>
+ * @exception NullPointerException if {@code stdName}
* is null.
*/
public ECGenParameterSpec(String stdName) {
--- a/jdk/src/share/classes/java/security/spec/ECParameterSpec.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/ECParameterSpec.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2003, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -49,12 +49,12 @@
* @param curve the elliptic curve which this parameter
* defines.
* @param g the generator which is also known as the base point.
- * @param n the order of the generator <code>g</code>.
+ * @param n the order of the generator {@code g}.
* @param h the cofactor.
- * @exception NullPointerException if <code>curve</code>,
- * <code>g</code>, or <code>n</code> is null.
- * @exception IllegalArgumentException if <code>n</code>
- * or <code>h</code> is not positive.
+ * @exception NullPointerException if {@code curve},
+ * {@code g}, or {@code n} is null.
+ * @exception IllegalArgumentException if {@code n}
+ * or {@code h} is not positive.
*/
public ECParameterSpec(EllipticCurve curve, ECPoint g,
BigInteger n, int h) {
--- a/jdk/src/share/classes/java/security/spec/ECPoint.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/ECPoint.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2003, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -54,11 +54,11 @@
/**
* Creates an ECPoint from the specified affine x-coordinate
- * <code>x</code> and affine y-coordinate <code>y</code>.
+ * {@code x} and affine y-coordinate {@code y}.
* @param x the affine x-coordinate.
* @param y the affine y-coordinate.
- * @exception NullPointerException if <code>x</code> or
- * <code>y</code> is null.
+ * @exception NullPointerException if {@code x} or
+ * {@code y} is null.
*/
public ECPoint(BigInteger x, BigInteger y) {
if ((x==null) || (y==null)) {
@@ -69,7 +69,7 @@
}
/**
- * Returns the affine x-coordinate <code>x</code>.
+ * Returns the affine x-coordinate {@code x}.
* Note: POINT_INFINITY has a null affine x-coordinate.
* @return the affine x-coordinate.
*/
@@ -78,7 +78,7 @@
}
/**
- * Returns the affine y-coordinate <code>y</code>.
+ * Returns the affine y-coordinate {@code y}.
* Note: POINT_INFINITY has a null affine y-coordinate.
* @return the affine y-coordinate.
*/
@@ -90,7 +90,7 @@
* Compares this elliptic curve point for equality with
* the specified object.
* @param obj the object to be compared.
- * @return true if <code>obj</code> is an instance of
+ * @return true if {@code obj} is an instance of
* ECPoint and the affine coordinates match, false otherwise.
*/
public boolean equals(Object obj) {
--- a/jdk/src/share/classes/java/security/spec/ECPrivateKeySpec.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/ECPrivateKeySpec.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2003, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -48,8 +48,8 @@
* @param s the private value.
* @param params the associated elliptic curve domain
* parameters.
- * @exception NullPointerException if <code>s</code>
- * or <code>params</code> is null.
+ * @exception NullPointerException if {@code s}
+ * or {@code params} is null.
*/
public ECPrivateKeySpec(BigInteger s, ECParameterSpec params) {
if (s == null) {
--- a/jdk/src/share/classes/java/security/spec/ECPublicKeySpec.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/ECPublicKeySpec.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2003, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -47,9 +47,9 @@
* @param w the public point.
* @param params the associated elliptic curve domain
* parameters.
- * @exception NullPointerException if <code>w</code>
- * or <code>params</code> is null.
- * @exception IllegalArgumentException if <code>w</code>
+ * @exception NullPointerException if {@code w}
+ * or {@code params} is null.
+ * @exception IllegalArgumentException if {@code w}
* is point at infinity, i.e. ECPoint.POINT_INFINITY
*/
public ECPublicKeySpec(ECPoint w, ECParameterSpec params) {
--- a/jdk/src/share/classes/java/security/spec/EllipticCurve.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/EllipticCurve.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2003, 2011, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -68,15 +68,15 @@
/**
* Creates an elliptic curve with the specified elliptic field
- * <code>field</code> and the coefficients <code>a</code> and
- * <code>b</code>.
+ * {@code field} and the coefficients {@code a} and
+ * {@code b}.
* @param field the finite field that this elliptic curve is over.
* @param a the first coefficient of this elliptic curve.
* @param b the second coefficient of this elliptic curve.
- * @exception NullPointerException if <code>field</code>,
- * <code>a</code>, or <code>b</code> is null.
- * @exception IllegalArgumentException if <code>a</code>
- * or <code>b</code> is not null and not in <code>field</code>.
+ * @exception NullPointerException if {@code field},
+ * {@code a}, or {@code b} is null.
+ * @exception IllegalArgumentException if {@code a}
+ * or {@code b} is not null and not in {@code field}.
*/
public EllipticCurve(ECField field, BigInteger a,
BigInteger b) {
@@ -85,18 +85,18 @@
/**
* Creates an elliptic curve with the specified elliptic field
- * <code>field</code>, the coefficients <code>a</code> and
- * <code>b</code>, and the <code>seed</code> used for curve generation.
+ * {@code field}, the coefficients {@code a} and
+ * {@code b}, and the {@code seed} used for curve generation.
* @param field the finite field that this elliptic curve is over.
* @param a the first coefficient of this elliptic curve.
* @param b the second coefficient of this elliptic curve.
* @param seed the bytes used during curve generation for later
* validation. Contents of this array are copied to protect against
* subsequent modification.
- * @exception NullPointerException if <code>field</code>,
- * <code>a</code>, or <code>b</code> is null.
- * @exception IllegalArgumentException if <code>a</code>
- * or <code>b</code> is not null and not in <code>field</code>.
+ * @exception NullPointerException if {@code field},
+ * {@code a}, or {@code b} is null.
+ * @exception IllegalArgumentException if {@code a}
+ * or {@code b} is not null and not in {@code field}.
*/
public EllipticCurve(ECField field, BigInteger a,
BigInteger b, byte[] seed) {
@@ -122,9 +122,9 @@
}
/**
- * Returns the finite field <code>field</code> that this
+ * Returns the finite field {@code field} that this
* elliptic curve is over.
- * @return the field <code>field</code> that this curve
+ * @return the field {@code field} that this curve
* is over.
*/
public ECField getField() {
@@ -132,27 +132,27 @@
}
/**
- * Returns the first coefficient <code>a</code> of the
+ * Returns the first coefficient {@code a} of the
* elliptic curve.
- * @return the first coefficient <code>a</code>.
+ * @return the first coefficient {@code a}.
*/
public BigInteger getA() {
return a;
}
/**
- * Returns the second coefficient <code>b</code> of the
+ * Returns the second coefficient {@code b} of the
* elliptic curve.
- * @return the second coefficient <code>b</code>.
+ * @return the second coefficient {@code b}.
*/
public BigInteger getB() {
return b;
}
/**
- * Returns the seeding bytes <code>seed</code> used
+ * Returns the seeding bytes {@code seed} used
* during curve generation. May be null if not specified.
- * @return the seeding bytes <code>seed</code>. A new
+ * @return the seeding bytes {@code seed}. A new
* array is returned each time this method is called.
*/
public byte[] getSeed() {
@@ -164,7 +164,7 @@
* Compares this elliptic curve for equality with the
* specified object.
* @param obj the object to be compared.
- * @return true if <code>obj</code> is an instance of
+ * @return true if {@code obj} is an instance of
* EllipticCurve and the field, A, and B match, false otherwise.
*/
public boolean equals(Object obj) {
--- a/jdk/src/share/classes/java/security/spec/EncodedKeySpec.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/EncodedKeySpec.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1997, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -49,7 +49,7 @@
*
* @param encodedKey the encoded key. The contents of the
* array are copied to protect against subsequent modification.
- * @exception NullPointerException if <code>encodedKey</code>
+ * @exception NullPointerException if {@code encodedKey}
* is null.
*/
public EncodedKeySpec(byte[] encodedKey) {
@@ -74,9 +74,9 @@
* (see {@link java.security.Key Key}) can be transformed
* (see {@link java.security.KeyFactory KeyFactory})
* into this key specification (or a subclass of it),
- * <code>getFormat</code> called
+ * {@code getFormat} called
* on the opaque key returns the same value as the
- * <code>getFormat</code> method
+ * {@code getFormat} method
* of this key specification.
*
* @return a string representation of the encoding format.
--- a/jdk/src/share/classes/java/security/spec/InvalidKeySpecException.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/InvalidKeySpecException.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1997, 2003, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -63,13 +63,13 @@
}
/**
- * Creates a <code>InvalidKeySpecException</code> with the specified
+ * Creates a {@code InvalidKeySpecException} with the specified
* detail message and cause.
*
* @param message the detail message (which is saved for later retrieval
* by the {@link #getMessage()} method).
* @param cause the cause (which is saved for later retrieval by the
- * {@link #getCause()} method). (A <tt>null</tt> value is permitted,
+ * {@link #getCause()} method). (A {@code null} value is permitted,
* and indicates that the cause is nonexistent or unknown.)
* @since 1.5
*/
@@ -78,13 +78,13 @@
}
/**
- * Creates a <code>InvalidKeySpecException</code> with the specified cause
- * and a detail message of <tt>(cause==null ? null : cause.toString())</tt>
+ * Creates a {@code InvalidKeySpecException} with the specified cause
+ * and a detail message of {@code (cause==null ? null : cause.toString())}
* (which typically contains the class and detail message of
- * <tt>cause</tt>).
+ * {@code cause}).
*
* @param cause the cause (which is saved for later retrieval by the
- * {@link #getCause()} method). (A <tt>null</tt> value is permitted,
+ * {@link #getCause()} method). (A {@code null} value is permitted,
* and indicates that the cause is nonexistent or unknown.)
* @since 1.5
*/
--- a/jdk/src/share/classes/java/security/spec/KeySpec.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/KeySpec.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1997, 1999, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -36,7 +36,7 @@
* <P> A key may be specified in an algorithm-specific way, or in an
* algorithm-independent encoding format (such as ASN.1).
* For example, a DSA private key may be specified by its components
- * <code>x</code>, <code>p</code>, <code>q</code>, and <code>g</code>
+ * {@code x}, {@code p}, {@code q}, and {@code g}
* (see {@link DSAPrivateKeySpec}), or it may be
* specified using its DER encoding
* (see {@link PKCS8EncodedKeySpec}).
--- a/jdk/src/share/classes/java/security/spec/MGF1ParameterSpec.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/MGF1ParameterSpec.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2003, 2012, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -92,7 +92,7 @@
*
* @param mdName the algorithm name for the message digest
* used in this mask generation function MGF1.
- * @exception NullPointerException if <code>mdName</code> is null.
+ * @exception NullPointerException if {@code mdName} is null.
*/
public MGF1ParameterSpec(String mdName) {
if (mdName == null) {
--- a/jdk/src/share/classes/java/security/spec/PKCS8EncodedKeySpec.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/PKCS8EncodedKeySpec.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1997, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -27,8 +27,8 @@
/**
* This class represents the ASN.1 encoding of a private key,
- * encoded according to the ASN.1 type <code>PrivateKeyInfo</code>.
- * The <code>PrivateKeyInfo</code> syntax is defined in the PKCS#8 standard
+ * encoded according to the ASN.1 type {@code PrivateKeyInfo}.
+ * The {@code PrivateKeyInfo} syntax is defined in the PKCS#8 standard
* as follows:
*
* <pre>
@@ -67,7 +67,7 @@
* @param encodedKey the key, which is assumed to be
* encoded according to the PKCS #8 standard. The contents of
* the array are copied to protect against subsequent modification.
- * @exception NullPointerException if <code>encodedKey</code>
+ * @exception NullPointerException if {@code encodedKey}
* is null.
*/
public PKCS8EncodedKeySpec(byte[] encodedKey) {
@@ -88,7 +88,7 @@
* Returns the name of the encoding format associated with this
* key specification.
*
- * @return the string <code>"PKCS#8"</code>.
+ * @return the string {@code "PKCS#8"}.
*/
public final String getFormat() {
return "PKCS#8";
--- a/jdk/src/share/classes/java/security/spec/PSSParameterSpec.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/PSSParameterSpec.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2001, 2012, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2001, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -91,14 +91,14 @@
public static final PSSParameterSpec DEFAULT = new PSSParameterSpec();
/**
- * Constructs a new <code>PSSParameterSpec</code> as defined in
+ * Constructs a new {@code PSSParameterSpec} as defined in
* the PKCS #1 standard using the default values.
*/
private PSSParameterSpec() {
}
/**
- * Creates a new <code>PSSParameterSpec</code> as defined in
+ * Creates a new {@code PSSParameterSpec} as defined in
* the PKCS #1 standard using the specified message digest,
* mask generation function, parameters for mask generation
* function, salt length, and trailer field values.
@@ -111,10 +111,10 @@
* getMGFParameters().
* @param saltLen the length of salt.
* @param trailerField the value of the trailer field.
- * @exception NullPointerException if <code>mdName</code>,
- * or <code>mgfName</code> is null.
- * @exception IllegalArgumentException if <code>saltLen</code>
- * or <code>trailerField</code> is less than 0.
+ * @exception NullPointerException if {@code mdName},
+ * or {@code mgfName} is null.
+ * @exception IllegalArgumentException if {@code saltLen}
+ * or {@code trailerField} is less than 0.
* @since 1.5
*/
public PSSParameterSpec(String mdName, String mgfName,
@@ -143,13 +143,13 @@
}
/**
- * Creates a new <code>PSSParameterSpec</code>
+ * Creates a new {@code PSSParameterSpec}
* using the specified salt length and other default values as
* defined in PKCS#1.
*
* @param saltLen the length of salt in bits to be used in PKCS#1
* PSS encoding.
- * @exception IllegalArgumentException if <code>saltLen</code> is
+ * @exception IllegalArgumentException if {@code saltLen} is
* less than 0.
*/
public PSSParameterSpec(int saltLen) {
--- a/jdk/src/share/classes/java/security/spec/RSAKeyGenParameterSpec.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/RSAKeyGenParameterSpec.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1999, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1999, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -55,7 +55,7 @@
public static final BigInteger F4 = BigInteger.valueOf(65537);
/**
- * Constructs a new <code>RSAParameterSpec</code> object from the
+ * Constructs a new {@code RSAParameterSpec} object from the
* given keysize and public-exponent value.
*
* @param keysize the modulus size (specified in number of bits)
--- a/jdk/src/share/classes/java/security/spec/RSAMultiPrimePrivateCrtKeySpec.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/RSAMultiPrimePrivateCrtKeySpec.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2001, 2003, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2001, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -57,12 +57,12 @@
private final RSAOtherPrimeInfo otherPrimeInfo[];
/**
- * Creates a new <code>RSAMultiPrimePrivateCrtKeySpec</code>
+ * Creates a new {@code RSAMultiPrimePrivateCrtKeySpec}
* given the modulus, publicExponent, privateExponent,
* primeP, primeQ, primeExponentP, primeExponentQ,
* crtCoefficient, and otherPrimeInfo as defined in PKCS#1 v2.1.
*
- * <p>Note that the contents of <code>otherPrimeInfo</code>
+ * <p>Note that the contents of {@code otherPrimeInfo}
* are copied to protect against subsequent modification when
* constructing this object.
*
@@ -78,13 +78,13 @@
* @param otherPrimeInfo triplets of the rest of primes, null can be
* specified if there are only two prime factors (p and q).
* @exception NullPointerException if any of the parameters, i.e.
- * <code>modulus</code>,
- * <code>publicExponent</code>, <code>privateExponent</code>,
- * <code>primeP</code>, <code>primeQ</code>,
- * <code>primeExponentP</code>, <code>primeExponentQ</code>,
- * <code>crtCoefficient</code>, is null.
+ * {@code modulus},
+ * {@code publicExponent}, {@code privateExponent},
+ * {@code primeP}, {@code primeQ},
+ * {@code primeExponentP}, {@code primeExponentQ},
+ * {@code crtCoefficient}, is null.
* @exception IllegalArgumentException if an empty, i.e. 0-length,
- * <code>otherPrimeInfo</code> is specified.
+ * {@code otherPrimeInfo} is specified.
*/
public RSAMultiPrimePrivateCrtKeySpec(BigInteger modulus,
BigInteger publicExponent,
--- a/jdk/src/share/classes/java/security/spec/RSAOtherPrimeInfo.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/RSAOtherPrimeInfo.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2001, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2001, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -58,7 +58,7 @@
/**
- * Creates a new <code>RSAOtherPrimeInfo</code>
+ * Creates a new {@code RSAOtherPrimeInfo}
* given the prime, primeExponent, and
* crtCoefficient as defined in PKCS#1.
*
@@ -67,8 +67,8 @@
* @param crtCoefficient the Chinese Remainder Theorem
* coefficient.
* @exception NullPointerException if any of the parameters, i.e.
- * <code>prime</code>, <code>primeExponent</code>,
- * <code>crtCoefficient</code>, is null.
+ * {@code prime}, {@code primeExponent},
+ * {@code crtCoefficient}, is null.
*
*/
public RSAOtherPrimeInfo(BigInteger prime,
--- a/jdk/src/share/classes/java/security/spec/RSAPrivateCrtKeySpec.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/RSAPrivateCrtKeySpec.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1998, 2003, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -55,7 +55,7 @@
/**
- * Creates a new <code>RSAPrivateCrtKeySpec</code>
+ * Creates a new {@code RSAPrivateCrtKeySpec}
* given the modulus, publicExponent, privateExponent,
* primeP, primeQ, primeExponentP, primeExponentQ, and
* crtCoefficient as defined in PKCS#1.
--- a/jdk/src/share/classes/java/security/spec/X509EncodedKeySpec.java Tue Jun 25 14:31:29 2013 -0700
+++ b/jdk/src/share/classes/java/security/spec/X509EncodedKeySpec.java Tue Jun 25 14:41:46 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1997, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -27,8 +27,8 @@
/**
* This class represents the ASN.1 encoding of a public key,
- * encoded according to the ASN.1 type <code>SubjectPublicKeyInfo</code>.
- * The <code>SubjectPublicKeyInfo</code> syntax is defined in the X.509
+ * encoded according to the ASN.1 type {@code SubjectPublicKeyInfo}.
+ * The {@code SubjectPublicKeyInfo} syntax is defined in the X.509
* standard as follows:
*
* <pre>
@@ -57,7 +57,7 @@
* @param encodedKey the key, which is assumed to be
* encoded according to the X.509 standard. The contents of the
* array are copied to protect against subsequent modification.
- * @exception NullPointerException if <code>encodedKey</code>
+ * @exception NullPointerException if {@code encodedKey}
* is null.
*/
public X509EncodedKeySpec(byte[] encodedKey) {
@@ -78,7 +78,7 @@
* Returns the name of the encoding format associated with this
* key specification.
*
- * @return the string <code>"X.509"</code>.
+ * @return the string {@code "X.509"}.
*/
public final String getFormat() {
return "X.509";