stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

8017326: Cleanup of the javadoc <code> tag in java.security.spec

Browse Source 
Convert javadoc <code> and <tt> tags to {@code ...}

Reviewed-by: darcy
This commit is contained in:
Jason Uh 2013-06-25 14:41:46 -07:00
parent 1b06c50919
commit d30f173a22
23 changed files with 172 additions and 172 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
jdk/src/share/classes/java/security/spec/DSAGenParameterSpec.java
View File

@ -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 @@ public final class DSAGenParameterSpec implements AlgorithmParameterSpec {
/**
* 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 @@ public final class DSAGenParameterSpec implements AlgorithmParameterSpec {
/**
* 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) {

14
jdk/src/share/classes/java/security/spec/DSAParameterSpec.java
View File

@ -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 @@ java.security.interfaces.DSAParams {
}
/**
* 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;

18
jdk/src/share/classes/java/security/spec/DSAPrivateKeySpec.java
View File

@ -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 @@ public class DSAPrivateKeySpec implements KeySpec {
}
/**
* 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;

18
jdk/src/share/classes/java/security/spec/DSAPublicKeySpec.java
View File

@ -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 @@ public class DSAPublicKeySpec implements KeySpec {
}
/**
* 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;

70
jdk/src/share/classes/java/security/spec/ECFieldF2m.java
View File

@ -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 @@ public class ECFieldF2m implements ECField {
/**
* 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 @@ public class ECFieldF2m implements ECField {
/**
* 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} &gt; {@code k} &gt;= 1) or a
* pentanomial (X^{@code m} + X^{@code k3}
* + X^{@code k2} + X^{@code k1} + 1 with
* {@code m} &gt; {@code k3} &gt; {@code k2}
* &gt; {@code k1} &gt;= 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 @@ public class ECFieldF2m implements ECField {
/**
* 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} &gt; {@code k} &gt;= 1) or a
* pentanomial (X^{@code m} + X^{@code k3}
* + X^{@code k2} + X^{@code k1} + 1 with
* {@code m} &gt; {@code k3} &gt; {@code k2}
* &gt; {@code k1} &gt;= 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 @@ public class ECFieldF2m implements ECField {
}
/**
* 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 @@ public class ECFieldF2m implements ECField {
}
/**
* 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 @@ public class ECFieldF2m implements ECField {
* 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) {

12
jdk/src/share/classes/java/security/spec/ECFieldFp.java
View File

@ -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 @@ public class ECFieldFp implements ECField {
/**
* 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 @@ public class ECFieldFp implements ECField {
};
/**
* 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 @@ public class ECFieldFp implements ECField {
* 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) {

6
jdk/src/share/classes/java/security/spec/ECGenParameterSpec.java
View File

@ -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 @@ public class ECGenParameterSpec implements AlgorithmParameterSpec {
/**
* 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) {

12
jdk/src/share/classes/java/security/spec/ECParameterSpec.java
View File

@ -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 @@ public class ECParameterSpec implements AlgorithmParameterSpec {
* @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) {

14
jdk/src/share/classes/java/security/spec/ECPoint.java
View File

@ -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 @@ public class ECPoint {
/**
* 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 @@ public class ECPoint {
}
/**
* 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 @@ public class ECPoint {
}
/**
* 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 @@ public class ECPoint {
* 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) {

6
jdk/src/share/classes/java/security/spec/ECPrivateKeySpec.java
View File

@ -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 @@ public class ECPrivateKeySpec implements KeySpec {
* @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) {

8
jdk/src/share/classes/java/security/spec/ECPublicKeySpec.java
View File

@ -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 @@ public class ECPublicKeySpec implements KeySpec {
* @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) {

44
jdk/src/share/classes/java/security/spec/EllipticCurve.java
View File

@ -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 @@ public class EllipticCurve {
/**
* 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 @@ public class EllipticCurve {
/**
* 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 @@ public class EllipticCurve {
}
/**
* 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 @@ public class EllipticCurve {
}
/**
* 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 @@ public class EllipticCurve {
* 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) {

8
jdk/src/share/classes/java/security/spec/EncodedKeySpec.java
View File

@ -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 @@ public abstract class EncodedKeySpec implements KeySpec {
*
* @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 @@ public abstract class EncodedKeySpec implements KeySpec {
* (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.

14
jdk/src/share/classes/java/security/spec/InvalidKeySpecException.java
View File

@ -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 @@ public class InvalidKeySpecException extends GeneralSecurityException {
}
/**
* 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 @@ public class InvalidKeySpecException extends GeneralSecurityException {
}
/**
* 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
*/

4
jdk/src/share/classes/java/security/spec/KeySpec.java
View File

@ -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 @@ package java.security.spec;
* <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}).

4
jdk/src/share/classes/java/security/spec/MGF1ParameterSpec.java
View File

@ -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 @@ public class MGF1ParameterSpec implements AlgorithmParameterSpec {
*
* @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) {

10
jdk/src/share/classes/java/security/spec/PKCS8EncodedKeySpec.java
View File

@ -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 @@ package java.security.spec;
/**
* 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 @@ public class PKCS8EncodedKeySpec extends EncodedKeySpec {
* @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 @@ public class PKCS8EncodedKeySpec extends EncodedKeySpec {
* 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";

18
jdk/src/share/classes/java/security/spec/PSSParameterSpec.java
View File

@ -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 class PSSParameterSpec implements AlgorithmParameterSpec {
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 @@ public class PSSParameterSpec implements AlgorithmParameterSpec {
* 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 @@ public class PSSParameterSpec implements AlgorithmParameterSpec {
}
/**
* 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) {

4
jdk/src/share/classes/java/security/spec/RSAKeyGenParameterSpec.java
View File

@ -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 class RSAKeyGenParameterSpec implements AlgorithmParameterSpec {
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)

18
jdk/src/share/classes/java/security/spec/RSAMultiPrimePrivateCrtKeySpec.java
View File

@ -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 @@ public class RSAMultiPrimePrivateCrtKeySpec extends RSAPrivateKeySpec {
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 @@ public class RSAMultiPrimePrivateCrtKeySpec extends RSAPrivateKeySpec {
* @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,

8
jdk/src/share/classes/java/security/spec/RSAOtherPrimeInfo.java
View File

@ -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 @@ public class RSAOtherPrimeInfo {
/**
* 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 @@ public class RSAOtherPrimeInfo {
* @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,

4
jdk/src/share/classes/java/security/spec/RSAPrivateCrtKeySpec.java
View File

@ -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 @@ public class RSAPrivateCrtKeySpec extends RSAPrivateKeySpec {
/**
* 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.

10
jdk/src/share/classes/java/security/spec/X509EncodedKeySpec.java
View File

@ -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 @@ package java.security.spec;
/**
* 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 @@ public class X509EncodedKeySpec extends EncodedKeySpec {
* @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 @@ public class X509EncodedKeySpec extends EncodedKeySpec {
* 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";