diff --git a/src/java.base/share/classes/java/io/ObjectInputStream.java b/src/java.base/share/classes/java/io/ObjectInputStream.java index 6b5d5412402a2..8a9802bcd8ee5 100644 --- a/src/java.base/share/classes/java/io/ObjectInputStream.java +++ b/src/java.base/share/classes/java/io/ObjectInputStream.java @@ -241,6 +241,7 @@ * Java Object Serialization Specification, Section 1.13, * "Serialization of Records" for additional information. * + * @spec serialization/index.html Java Object Serialization Specification * @author Mike Warres * @author Roger Riggs * @see java.io.DataInput diff --git a/src/java.base/share/classes/java/io/ObjectOutputStream.java b/src/java.base/share/classes/java/io/ObjectOutputStream.java index fa954eea98824..c43b33cc08d6d 100644 --- a/src/java.base/share/classes/java/io/ObjectOutputStream.java +++ b/src/java.base/share/classes/java/io/ObjectOutputStream.java @@ -156,6 +156,7 @@ *

Records are serialized differently than ordinary serializable or externalizable * objects, see record serialization. * + * @spec serialization/index.html Java Object Serialization Specification * @author Mike Warres * @author Roger Riggs * @see java.io.DataOutput @@ -671,6 +672,7 @@ protected void writeStreamHeader() throws IOException { * * @param desc class descriptor to write to the stream * @throws IOException If an I/O error has occurred. + * @spec serialization/index.html Java Object Serialization Specification * @see java.io.ObjectInputStream#readClassDescriptor() * @see #useProtocolVersion(int) * @see java.io.ObjectStreamConstants#PROTOCOL_VERSION_1 diff --git a/src/java.base/share/classes/java/io/ObjectStreamClass.java b/src/java.base/share/classes/java/io/ObjectStreamClass.java index 9a055ddff5def..7aab73b8d6987 100644 --- a/src/java.base/share/classes/java/io/ObjectStreamClass.java +++ b/src/java.base/share/classes/java/io/ObjectStreamClass.java @@ -72,6 +72,7 @@ * * Java Object Serialization Specification, Section 4.6, "Stream Unique Identifiers". * + * @spec serialization/index.html Java Object Serialization Specification * @author Mike Warres * @author Roger Riggs * @see ObjectStreamField diff --git a/src/java.base/share/classes/java/io/Serial.java b/src/java.base/share/classes/java/io/Serial.java index d648f0461593e..c19aa65391a8f 100644 --- a/src/java.base/share/classes/java/io/Serial.java +++ b/src/java.base/share/classes/java/io/Serial.java @@ -94,6 +94,7 @@ * and methods reflectively and those fields and methods may appear * otherwise unused in a {@code Serializable} class. * + * @spec serialization/index.html Java Object Serialization Specification * @see Serializable * @see Externalizable * @since 14 diff --git a/src/java.base/share/classes/java/io/Serializable.java b/src/java.base/share/classes/java/io/Serializable.java index 680853abe2801..25cf2b70ab6dc 100644 --- a/src/java.base/share/classes/java/io/Serializable.java +++ b/src/java.base/share/classes/java/io/Serializable.java @@ -181,6 +181,7 @@ * the default computed value, but the requirement for matching * serialVersionUID values is waived for array classes. * + * @spec serialization/index.html Java Object Serialization Specification * @see java.io.ObjectOutputStream * @see java.io.ObjectInputStream * @see java.io.ObjectOutput diff --git a/src/java.base/share/classes/java/io/package-info.java b/src/java.base/share/classes/java/io/package-info.java index 81f61412eedc5..7030d1f0f77f3 100644 --- a/src/java.base/share/classes/java/io/package-info.java +++ b/src/java.base/share/classes/java/io/package-info.java @@ -48,6 +48,7 @@ *

  • {@extLink serialver_tool_reference The serialver tool}
    • * * + * @spec serialization/index.html Java Object Serialization Specification * @since 1.0 */ package java.io; diff --git a/src/java.base/share/classes/java/lang/Character.java b/src/java.base/share/classes/java/lang/Character.java index afe1fb8f7c043..fa3d9bd703f83 100644 --- a/src/java.base/share/classes/java/lang/Character.java +++ b/src/java.base/share/classes/java/lang/Character.java @@ -169,6 +169,7 @@ * use instances for synchronization, or unpredictable behavior may * occur. For example, in a future release, synchronization may fail. * + * @spec https://www.unicode.org/reports/tr27 Unicode 3.1.0 * @author Lee Boynton * @author Guy Steele * @author Akira Tanaka @@ -4490,6 +4491,7 @@ public static final UnicodeBlock forName(String blockName) { * {@link Character.UnicodeScript#COMMON Common} or * {@link Character.UnicodeScript#UNKNOWN Unknown}. * + * @spec https://www.unicode.org/reports/tr24 Unicode Script Property * @since 1.7 */ public static enum UnicodeScript { @@ -10577,6 +10579,8 @@ public static boolean isJavaIdentifierPart(int codePoint) { * @param ch the character to be tested. * @return {@code true} if the character may start a Unicode * identifier; {@code false} otherwise. + * @spec https://www.unicode.org/reports/tr44 Unicode Character Database + * @spec https://www.unicode.org/reports/tr31 Unicode Identifier and Pattern Syntax * @see Character#isJavaIdentifierStart(char) * @see Character#isLetter(char) * @see Character#isUnicodeIdentifierPart(char) @@ -10613,6 +10617,8 @@ public static boolean isUnicodeIdentifierStart(char ch) { * @param codePoint the character (Unicode code point) to be tested. * @return {@code true} if the character may start a Unicode * identifier; {@code false} otherwise. + * @spec https://www.unicode.org/reports/tr44 Unicode Character Database + * @spec https://www.unicode.org/reports/tr31 Unicode Identifier and Pattern Syntax * @see Character#isJavaIdentifierStart(int) * @see Character#isLetter(int) * @see Character#isUnicodeIdentifierPart(int) @@ -10662,6 +10668,8 @@ public static boolean isUnicodeIdentifierStart(int codePoint) { * @param ch the character to be tested. * @return {@code true} if the character may be part of a * Unicode identifier; {@code false} otherwise. + * @spec https://www.unicode.org/reports/tr44 Unicode Character Database + * @spec https://www.unicode.org/reports/tr31 Unicode Identifier and Pattern Syntax * @see Character#isIdentifierIgnorable(char) * @see Character#isJavaIdentifierPart(char) * @see Character#isLetterOrDigit(char) @@ -10707,6 +10715,8 @@ public static boolean isUnicodeIdentifierPart(char ch) { * @param codePoint the character (Unicode code point) to be tested. * @return {@code true} if the character may be part of a * Unicode identifier; {@code false} otherwise. + * @spec https://www.unicode.org/reports/tr44 Unicode Character Database + * @spec https://www.unicode.org/reports/tr31 Unicode Identifier and Pattern Syntax * @see Character#isIdentifierIgnorable(int) * @see Character#isJavaIdentifierPart(int) * @see Character#isLetterOrDigit(int) diff --git a/src/java.base/share/classes/java/lang/Enum.java b/src/java.base/share/classes/java/lang/Enum.java index 55926fc3a4014..962d02be910db 100644 --- a/src/java.base/share/classes/java/lang/Enum.java +++ b/src/java.base/share/classes/java/lang/Enum.java @@ -61,6 +61,7 @@ * java.util.EnumMap map} implementations are available. * * @param The type of the enum subclass + * @spec serialization/index.html Java Object Serialization Specification * @serial exclude * @author Josh Bloch * @author Neal Gafter diff --git a/src/java.base/share/classes/java/lang/Record.java b/src/java.base/share/classes/java/lang/Record.java index 2f8bd60ac5b4c..f83345f2a750a 100644 --- a/src/java.base/share/classes/java/lang/Record.java +++ b/src/java.base/share/classes/java/lang/Record.java @@ -67,6 +67,7 @@ * * then it must be the case that {@code r.equals(copy)}. * + * @spec serialization/index.html Java Object Serialization Specification * @apiNote * A record class that {@code implements} {@link java.io.Serializable} is said * to be a serializable record. Serializable records are serialized and diff --git a/src/java.base/share/classes/java/lang/Runtime.java b/src/java.base/share/classes/java/lang/Runtime.java index fd35265c0ccb0..8de70c376eee2 100644 --- a/src/java.base/share/classes/java/lang/Runtime.java +++ b/src/java.base/share/classes/java/lang/Runtime.java @@ -94,6 +94,7 @@ * of any method is executed, nor is any {@linkplain Thread.UncaughtExceptionHandler * uncaught exception handler}. * + * @spec jni/index.html Java Native Interface Specification * @implNote * Native code typically uses the * JNI Invocation API @@ -787,6 +788,7 @@ public void runFinalization() { * a native library image by the host system. * @throws NullPointerException if {@code filename} is * {@code null} + * @spec jni/index.html Java Native Interface Specification * @see java.lang.Runtime#getRuntime() * @see java.lang.SecurityException * @see java.lang.SecurityManager#checkLink(java.lang.String) @@ -852,6 +854,7 @@ void load0(Class fromClass, String filename) { * native library image by the host system. * @throws NullPointerException if {@code libname} is * {@code null} + * @spec jni/index.html Java Native Interface Specification * @see java.lang.SecurityException * @see java.lang.SecurityManager#checkLink(java.lang.String) */ diff --git a/src/java.base/share/classes/java/lang/System.java b/src/java.base/share/classes/java/lang/System.java index 0cb4624ad8a9a..e4633983d14db 100644 --- a/src/java.base/share/classes/java/lang/System.java +++ b/src/java.base/share/classes/java/lang/System.java @@ -2003,6 +2003,7 @@ public static void runFinalization() { * linked with the VM, or the library cannot be mapped to * a native library image by the host system. * @throws NullPointerException if {@code filename} is {@code null} + * @spec jni/index.html Java Native Interface Specification * @see java.lang.Runtime#load(java.lang.String) * @see java.lang.SecurityManager#checkLink(java.lang.String) */ @@ -2039,6 +2040,7 @@ public static void load(String filename) { * linked with the VM, or the library cannot be mapped to a * native library image by the host system. * @throws NullPointerException if {@code libname} is {@code null} + * @spec jni/index.html Java Native Interface Specification * @see java.lang.Runtime#loadLibrary(java.lang.String) * @see java.lang.SecurityManager#checkLink(java.lang.String) */ diff --git a/src/java.base/share/classes/java/lang/Thread.java b/src/java.base/share/classes/java/lang/Thread.java index 61da2ebf6f273..0379add3bb465 100644 --- a/src/java.base/share/classes/java/lang/Thread.java +++ b/src/java.base/share/classes/java/lang/Thread.java @@ -1908,6 +1908,7 @@ public final int getPriority() { * with no arguments. This may result in throwing a * {@code SecurityException}. * + * @spec jni/index.html Java Native Interface Specification * @implNote In the JDK Reference Implementation, if this thread is the * current thread, and it's a platform thread that was not attached to the * VM with the Java Native Interface diff --git a/src/java.base/share/classes/java/lang/foreign/package-info.java b/src/java.base/share/classes/java/lang/foreign/package-info.java index 87cfc200735b6..ac80cae09665e 100644 --- a/src/java.base/share/classes/java/lang/foreign/package-info.java +++ b/src/java.base/share/classes/java/lang/foreign/package-info.java @@ -234,5 +234,6 @@ * For every class in this package, unless specified otherwise, any method arguments of reference * type must not be null, and any null argument will elicit a {@code NullPointerException}. This fact is not individually * documented for methods of this API. + * @spec jni/index.html Java Native Interface Specification */ package java.lang.foreign; diff --git a/src/java.base/share/classes/java/lang/reflect/AccessibleObject.java b/src/java.base/share/classes/java/lang/reflect/AccessibleObject.java index 0fd1ab9d911a4..11f6792eb6ffc 100644 --- a/src/java.base/share/classes/java/lang/reflect/AccessibleObject.java +++ b/src/java.base/share/classes/java/lang/reflect/AccessibleObject.java @@ -71,6 +71,7 @@ * object corresponds to a member in an exported or open package * (see {@link #setAccessible(boolean)}).

    * + * @spec jni/index.html Java Native Interface Specification * @jls 6.6 Access Control * @since 1.2 * @revised 9 @@ -202,6 +203,7 @@ public static void setAccessible(AccessibleObject[] array, boolean flag) { * @param flag the new value for the {@code accessible} flag * @throws InaccessibleObjectException if access cannot be enabled * @throws SecurityException if the request is denied by the security manager + * @spec jni/index.html Java Native Interface Specification * @see #trySetAccessible * @see java.lang.invoke.MethodHandles#privateLookupIn * @revised 9 @@ -268,6 +270,7 @@ boolean setAccessible0(boolean flag) { * {@code false} if access cannot be enabled. * @throws SecurityException if the request is denied by the security manager * + * @spec jni/index.html Java Native Interface Specification * @since 9 * @see java.lang.invoke.MethodHandles#privateLookupIn */ @@ -461,6 +464,7 @@ public boolean isAccessible() { * declaring class} of the member. * * + * @spec jni/index.html Java Native Interface Specification * @since 9 * @jls 6.6 Access Control * @see #trySetAccessible diff --git a/src/java.base/share/classes/java/net/CookieHandler.java b/src/java.base/share/classes/java/net/CookieHandler.java index c845a79ebe6d2..92912dc6a8b12 100644 --- a/src/java.base/share/classes/java/net/CookieHandler.java +++ b/src/java.base/share/classes/java/net/CookieHandler.java @@ -46,6 +46,7 @@ * href="http://www.ietf.org/rfc/rfc2965.txt">RFC 2965: HTTP * State Management Mechanism * + * @spec https://www.rfc-editor.org/info/rfc2965 RFC 2965: HTTP State Management Mechanism * @author Yingxian Wang * @since 1.5 */ diff --git a/src/java.base/share/classes/java/net/CookieManager.java b/src/java.base/share/classes/java/net/CookieManager.java index b1540ad5612b9..9cb69b804937f 100644 --- a/src/java.base/share/classes/java/net/CookieManager.java +++ b/src/java.base/share/classes/java/net/CookieManager.java @@ -109,6 +109,7 @@ * *

    The implementation conforms to RFC 2965, section 3.3. * + * @spec https://www.rfc-editor.org/info/rfc2965 RFC 2965: HTTP State Management Mechanism * @see CookiePolicy * @author Edward Wang * @since 1.6 diff --git a/src/java.base/share/classes/java/net/HttpCookie.java b/src/java.base/share/classes/java/net/HttpCookie.java index 0214359ccded8..bc6c00bd13b7a 100644 --- a/src/java.base/share/classes/java/net/HttpCookie.java +++ b/src/java.base/share/classes/java/net/HttpCookie.java @@ -53,6 +53,8 @@ * *

    HttpCookie class can accept all these 3 forms of syntax. * + * @spec https://www.rfc-editor.org/info/rfc2109 RFC 2109: HTTP State Management Mechanism + * @spec https://www.rfc-editor.org/info/rfc2965 RFC 2965: HTTP State Management Mechanism * @author Edward Wang * @since 1.6 */ diff --git a/src/java.base/share/classes/java/net/IDN.java b/src/java.base/share/classes/java/net/IDN.java index f88d0b174de7c..c28d8e83f09b4 100644 --- a/src/java.base/share/classes/java/net/IDN.java +++ b/src/java.base/share/classes/java/net/IDN.java @@ -68,6 +68,13 @@ * Applications are responsible for taking adequate security measures when using * international domain names. * + * @spec https://www.rfc-editor.org/info/rfc1122 RFC 1122: Requirements for Internet Hosts - Communication Layers + * @spec https://www.rfc-editor.org/info/rfc1123 RFC 1123: Requirements for Internet Hosts - Application and Support + * @spec https://www.rfc-editor.org/info/rfc3454 RFC 3454: Preparation of Internationalized Strings ("stringprep") + * @spec https://www.rfc-editor.org/info/rfc3490 RFC 3490: Internationalizing Domain Names in Applications (IDNA) + * @spec https://www.rfc-editor.org/info/rfc3491 RFC 3491: Nameprep: A Stringprep Profile for Internationalized Domain Names (IDN) + * @spec https://www.rfc-editor.org/info/rfc3492 RFC 3492: Punycode: A Bootstring encoding of Unicode for Internationalized Domain Names in Applications (IDNA) + * @spec https://www.unicode.org/reports/tr36 Unicode Security Considerations * @author Edward Wang * @since 1.6 * @@ -107,6 +114,7 @@ public final class IDN { * @return the translated {@code String} * * @throws IllegalArgumentException if the input string doesn't conform to RFC 3490 specification + * @spec https://www.rfc-editor.org/info/rfc3490 RFC 3490: Internationalizing Domain Names in Applications (IDNA) */ public static String toASCII(String input, int flag) { @@ -146,6 +154,7 @@ public static String toASCII(String input, int flag) * @return the translated {@code String} * * @throws IllegalArgumentException if the input string doesn't conform to RFC 3490 specification + * @spec https://www.rfc-editor.org/info/rfc3490 RFC 3490: Internationalizing Domain Names in Applications (IDNA) */ public static String toASCII(String input) { return toASCII(input, 0); @@ -169,6 +178,7 @@ public static String toASCII(String input) { * @param flag process flag; can be 0 or any logical OR of possible flags * * @return the translated {@code String} + * @spec https://www.rfc-editor.org/info/rfc3490 RFC 3490: Internationalizing Domain Names in Applications (IDNA) */ public static String toUnicode(String input, int flag) { int p = 0, q = 0; @@ -205,6 +215,7 @@ public static String toUnicode(String input, int flag) { * @param input the string to be processed * * @return the translated {@code String} + * @spec https://www.rfc-editor.org/info/rfc3490 RFC 3490: Internationalizing Domain Names in Applications (IDNA) */ public static String toUnicode(String input) { return toUnicode(input, 0); diff --git a/src/java.base/share/classes/java/net/Inet4Address.java b/src/java.base/share/classes/java/net/Inet4Address.java index 921818c4525f9..c72e150f24912 100644 --- a/src/java.base/share/classes/java/net/Inet4Address.java +++ b/src/java.base/share/classes/java/net/Inet4Address.java @@ -79,6 +79,9 @@ * 255 are global. However, the administrative scoping is preferred. * Please refer to * RFC 2365: Administratively Scoped IP Multicast + * @spec https://www.rfc-editor.org/info/rfc1918 RFC 1918: Address Allocation for Private Internets + * @spec https://www.rfc-editor.org/info/rfc2365 RFC 2365: Administratively Scoped IP Multicast + * @spec https://www.rfc-editor.org/info/rfc790 RFC 790: Assigned numbers * @since 1.4 */ diff --git a/src/java.base/share/classes/java/net/Inet6Address.java b/src/java.base/share/classes/java/net/Inet6Address.java index bef9adab73a49..80f8379a2c4b5 100644 --- a/src/java.base/share/classes/java/net/Inet6Address.java +++ b/src/java.base/share/classes/java/net/Inet6Address.java @@ -169,6 +169,7 @@ *

    Note also, that the numeric scope_id can be retrieved from * Inet6Address instances returned from the NetworkInterface class. This can be * used to find out the current scope ids configured on the system. + * @spec https://www.rfc-editor.org/info/rfc2373 RFC 2373: IP Version 6 Addressing Architecture * @since 1.4 */ diff --git a/src/java.base/share/classes/java/net/InetAddress.java b/src/java.base/share/classes/java/net/InetAddress.java index faa0d08524409..4e7919d474a72 100644 --- a/src/java.base/share/classes/java/net/InetAddress.java +++ b/src/java.base/share/classes/java/net/InetAddress.java @@ -216,6 +216,10 @@ * * * + * @spec https://www.rfc-editor.org/info/rfc1918 RFC 1918: Address Allocation for Private Internets + * @spec https://www.rfc-editor.org/info/rfc2365 RFC 2365: Administratively Scoped IP Multicast + * @spec https://www.rfc-editor.org/info/rfc2373 RFC 2373: IP Version 6 Addressing Architecture + * @spec https://www.rfc-editor.org/info/rfc790 RFC 790: Assigned numbers * @author Chris Warth * @see java.net.InetAddress#getByAddress(byte[]) * @see java.net.InetAddress#getByAddress(java.lang.String, byte[]) @@ -1408,6 +1412,8 @@ public static InetAddress getByAddress(String host, byte[] addr) * for a global IPv6 address. * @throws SecurityException if a security manager exists * and its checkConnect method doesn't allow the operation + * @spec https://www.rfc-editor.org/info/rfc2373 RFC 2373: IP Version 6 Addressing Architecture + * @spec https://www.rfc-editor.org/info/rfc3330 RFC 3330: Special-Use IPv4 Addresses */ public static InetAddress getByName(String host) throws UnknownHostException { @@ -1451,6 +1457,8 @@ public static InetAddress getByName(String host) * @throws SecurityException if a security manager exists and its * {@code checkConnect} method doesn't allow the operation. * + * @spec https://www.rfc-editor.org/info/rfc2373 RFC 2373: IP Version 6 Addressing Architecture + * @spec https://www.rfc-editor.org/info/rfc3330 RFC 3330: Special-Use IPv4 Addresses * @see SecurityManager#checkConnect */ public static InetAddress[] getAllByName(String host) diff --git a/src/java.base/share/classes/java/net/ResponseCache.java b/src/java.base/share/classes/java/net/ResponseCache.java index d8ca9d2077319..49d0a1aa44591 100644 --- a/src/java.base/share/classes/java/net/ResponseCache.java +++ b/src/java.base/share/classes/java/net/ResponseCache.java @@ -55,6 +55,7 @@ * href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616: Hypertext * Transfer Protocol -- HTTP/1.1 * + * @spec https://www.rfc-editor.org/info/rfc2616 RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1 * @author Yingxian Wang * @since 1.5 */ diff --git a/src/java.base/share/classes/java/net/SocketPermission.java b/src/java.base/share/classes/java/net/SocketPermission.java index 07c367b6ba7da..1182cce723c9f 100644 --- a/src/java.base/share/classes/java/net/SocketPermission.java +++ b/src/java.base/share/classes/java/net/SocketPermission.java @@ -134,6 +134,7 @@ * transfer and share confidential data among parties who may not * otherwise have access to the data. * + * @spec https://www.rfc-editor.org/info/rfc2732 RFC 2732: Format for Literal IPv6 Addresses in URL's * @see java.security.Permissions * @see SocketPermission * diff --git a/src/java.base/share/classes/java/net/StandardSocketOptions.java b/src/java.base/share/classes/java/net/StandardSocketOptions.java index bf5a9df57970c..c889911e08f58 100644 --- a/src/java.base/share/classes/java/net/StandardSocketOptions.java +++ b/src/java.base/share/classes/java/net/StandardSocketOptions.java @@ -57,6 +57,7 @@ private StandardSocketOptions() { } * require that the Java virtual machine be started with implementation * specific privileges to enable this option or send broadcast datagrams. * + * @spec https://www.rfc-editor.org/info/rfc919 RFC 919: Broadcasting Internet Datagrams * @see RFC 929: * Broadcasting Internet Datagrams * @see DatagramSocket#setBroadcast @@ -77,6 +78,7 @@ private StandardSocketOptions() { } *

    The initial value of this socket option is {@code FALSE}. The socket * option may be enabled or disabled at any time. * + * @spec https://www.rfc-editor.org/info/rfc1122 RFC 1122: Requirements for Internet Hosts - Communication Layers * @see RFC 1122 * Requirements for Internet Hosts -- Communication Layers * @see Socket#setKeepAlive @@ -147,6 +149,7 @@ private StandardSocketOptions() { } * socket receive buffer to be changed after the socket is bound is system * dependent. * + * @spec https://www.rfc-editor.org/info/rfc1323 RFC 1323: TCP Extensions for High Performance * @see RFC 1323: TCP * Extensions for High Performance * @see Socket#setReceiveBufferSize @@ -179,6 +182,7 @@ private StandardSocketOptions() { } * after the socket is bound has no effect. The default value of this * socket option is system dependent. * + * @spec https://www.rfc-editor.org/info/rfc793 RFC 793: Transmission Control Protocol * @see RFC 793: Transmission * Control Protocol * @see ServerSocket#setReuseAddress @@ -268,6 +272,8 @@ private StandardSocketOptions() { } * {@link StandardProtocolFamily#INET6 IPv6} socket, is not defined in this * release. * + * @spec https://www.rfc-editor.org/info/rfc1349 RFC 1349: Type of Service in the Internet Protocol Suite + * @spec https://www.rfc-editor.org/info/rfc2474 RFC 2474: Definition of the Differentiated Services Field (DS Field) in the IPv4 and IPv6 Headers * @see DatagramSocket#setTrafficClass */ public static final SocketOption IP_TOS = @@ -366,6 +372,7 @@ private StandardSocketOptions() { } * disabled. If it cannot, then invoking the {@code setOption} method to * disable the option has no effect. * + * @spec https://www.rfc-editor.org/info/rfc1122 RFC 1122: Requirements for Internet Hosts - Communication Layers * @see RFC 1122: * Requirements for Internet Hosts -- Communication Layers * @see Socket#setTcpNoDelay diff --git a/src/java.base/share/classes/java/net/URI.java b/src/java.base/share/classes/java/net/URI.java index 9c2daae3ce248..0aa2464d9b00f 100644 --- a/src/java.base/share/classes/java/net/URI.java +++ b/src/java.base/share/classes/java/net/URI.java @@ -465,6 +465,11 @@ * resolution as well as the network I/O operations of looking up the host and * opening a connection to the specified resource. * + * @spec https://www.rfc-editor.org/info/rfc2279 RFC 2279: UTF-8, a transformation format of ISO 10646 + * @spec https://www.rfc-editor.org/info/rfc2373 RFC 2373: IP Version 6 Addressing Architecture + * @spec https://www.rfc-editor.org/info/rfc2396 RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax + * @spec https://www.rfc-editor.org/info/rfc2732 RFC 2732: Format for Literal IPv6 Addresses in URL's + * @spec https://www.rfc-editor.org/info/rfc3986 RFC 3986: Uniform Resource Identifier (URI): Generic Syntax * @apiNote * * Applications working with file paths and file URIs should take great @@ -623,6 +628,9 @@ private URI() { } // Used internally * @throws URISyntaxException * If the given string violates RFC 2396, as augmented * by the above deviations + * @spec https://www.rfc-editor.org/info/rfc2373 RFC 2373: IP Version 6 Addressing Architecture + * @spec https://www.rfc-editor.org/info/rfc2396 RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax + * @spec https://www.rfc-editor.org/info/rfc2732 RFC 2732: Format for Literal IPv6 Addresses in URL's */ public URI(String str) throws URISyntaxException { new Parser(str).parse(false); @@ -700,6 +708,7 @@ public URI(String str) throws URISyntaxException { * if the URI string constructed from the given components violates * RFC 2396, or if the authority component of the string is * present but cannot be parsed as a server-based authority + * @spec https://www.rfc-editor.org/info/rfc2396 RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax */ public URI(String scheme, String userInfo, String host, int port, @@ -773,6 +782,7 @@ public URI(String scheme, * if the URI string constructed from the given components violates * RFC 2396, or if the authority component of the string is * present but cannot be parsed as a server-based authority + * @spec https://www.rfc-editor.org/info/rfc2396 RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax */ public URI(String scheme, String authority, @@ -961,6 +971,7 @@ public static URI create(String str) { * If the authority component of this URI is defined * but cannot be parsed as a server-based authority * according to RFC 2396 + * @spec https://www.rfc-editor.org/info/rfc2396 RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax */ public URI parseServerAuthority() throws URISyntaxException @@ -1010,6 +1021,7 @@ public URI parseServerAuthority() * * @return A URI equivalent to this URI, * but whose path is in normal form + * @spec https://www.rfc-editor.org/info/rfc2396 RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax */ public URI normalize() { return normalize(this); @@ -1068,6 +1080,7 @@ public URI normalize() { * * @throws NullPointerException * If {@code uri} is {@code null} + * @spec https://www.rfc-editor.org/info/rfc2396 RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax */ public URI resolve(URI uri) { return resolve(this, uri); @@ -1350,6 +1363,7 @@ public String getUserInfo() { * * @return The host component of this URI, * or {@code null} if the host is undefined + * @spec https://www.rfc-editor.org/info/rfc2373 RFC 2373: IP Version 6 Addressing Architecture */ public String getHost() { return host; @@ -1694,6 +1708,7 @@ public int compareTo(URI that) { * section 5.2, step 7.

    * * @return The string form of this URI + * @spec https://www.rfc-editor.org/info/rfc2396 RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax */ public String toString() { String s = string; diff --git a/src/java.base/share/classes/java/net/URL.java b/src/java.base/share/classes/java/net/URL.java index 56793be1e974f..2edb0a3f56cc0 100644 --- a/src/java.base/share/classes/java/net/URL.java +++ b/src/java.base/share/classes/java/net/URL.java @@ -170,6 +170,9 @@ * used, but only for HTML form encoding, which is not the same * as the encoding scheme defined in RFC2396. * + * @spec https://www.rfc-editor.org/info/rfc2396 RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax + * @spec https://www.rfc-editor.org/info/rfc2732 RFC 2732: Format for Literal IPv6 Addresses in URL's + * @spec https://www.rfc-editor.org/info/rfc3986 RFC 3986: Uniform Resource Identifier (URI): Generic Syntax * @apiNote * * @@ -393,6 +396,8 @@ public final class URL implements java.io.Serializable { * is a negative number other than -1, or if the * underlying stream handler implementation rejects, * or is known to reject, the {@code URL} + * @spec https://www.rfc-editor.org/info/rfc2373 RFC 2373: IP Version 6 Addressing Architecture + * @spec https://www.rfc-editor.org/info/rfc2732 RFC 2732: Format for Literal IPv6 Addresses in URL's * @see java.lang.System#getProperty(java.lang.String) * @see java.net.URL#setURLStreamHandlerFactory( * java.net.URLStreamHandlerFactory) diff --git a/src/java.base/share/classes/java/net/URLConnection.java b/src/java.base/share/classes/java/net/URLConnection.java index ea283ae48d0df..8dd627cbb7531 100644 --- a/src/java.base/share/classes/java/net/URLConnection.java +++ b/src/java.base/share/classes/java/net/URLConnection.java @@ -132,6 +132,7 @@ * instance, unless particular protocol specifications specify different behaviours * for it. * + * @spec https://www.rfc-editor.org/info/rfc2616 RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1 * @author James Gosling * @see java.net.URL#openConnection() * @see java.net.URLConnection#connect() diff --git a/src/java.base/share/classes/java/net/URLDecoder.java b/src/java.base/share/classes/java/net/URLDecoder.java index 8a67e8b06cdc8..f6f607528afd4 100644 --- a/src/java.base/share/classes/java/net/URLDecoder.java +++ b/src/java.base/share/classes/java/net/URLDecoder.java @@ -165,6 +165,7 @@ public static String decode(String s, String enc) throws UnsupportedEncodingExce * UTF-8 should be used. Not doing so may introduce * incompatibilities. * + * @spec https://www.w3.org/TR/html4 HTML 4.01 Specification * @implNote This implementation will throw an {@link java.lang.IllegalArgumentException} * when illegal strings are encountered. * diff --git a/src/java.base/share/classes/java/net/URLEncoder.java b/src/java.base/share/classes/java/net/URLEncoder.java index b48c90c528561..4341d48b1c3d3 100644 --- a/src/java.base/share/classes/java/net/URLEncoder.java +++ b/src/java.base/share/classes/java/net/URLEncoder.java @@ -71,6 +71,7 @@ * ü is encoded as two bytes C3 (hex) and BC (hex), and the * character @ is encoded as one byte 40 (hex). * + * @spec https://www.w3.org/TR/html4 HTML 4.01 Specification * @see Charset#defaultCharset() * * @author Herb Jellinek @@ -217,6 +218,7 @@ public static String encode(String s, String enc) * @param charset the given charset * @return the translated {@code String}. * @throws NullPointerException if {@code s} or {@code charset} is {@code null}. + * @spec https://www.w3.org/TR/html4 HTML 4.01 Specification * @see URLDecoder#decode(java.lang.String, Charset) * @since 10 */ diff --git a/src/java.base/share/classes/java/net/URLPermission.java b/src/java.base/share/classes/java/net/URLPermission.java index 605edf9e92c5f..23ef6543b5546 100644 --- a/src/java.base/share/classes/java/net/URLPermission.java +++ b/src/java.base/share/classes/java/net/URLPermission.java @@ -148,6 +148,8 @@ * from being set by application code, regardless of whether the security policy * in force, permits it. * + * @spec https://www.rfc-editor.org/info/rfc2296 RFC 2296: HTTP Remote Variant Selection Algorithm -- RVSA/1.0 + * @spec https://www.rfc-editor.org/info/rfc2732 RFC 2732: Format for Literal IPv6 Addresses in URL's * @since 1.8 */ public final class URLPermission extends Permission { diff --git a/src/java.base/share/classes/java/nio/channels/MulticastChannel.java b/src/java.base/share/classes/java/nio/channels/MulticastChannel.java index 720293b2dc7db..5630820370e88 100644 --- a/src/java.base/share/classes/java/nio/channels/MulticastChannel.java +++ b/src/java.base/share/classes/java/nio/channels/MulticastChannel.java @@ -117,6 +117,10 @@ * MembershipKey key = dc.join(group, ni); * * + * @spec https://www.rfc-editor.org/info/rfc2236 RFC 2236: Internet Group Management Protocol, Version 2 + * @spec https://www.rfc-editor.org/info/rfc2710 RFC 2710: Multicast Listener Discovery (MLD) for IPv6 + * @spec https://www.rfc-editor.org/info/rfc3376 RFC 3376: Internet Group Management Protocol, Version 3 + * @spec https://www.rfc-editor.org/info/rfc3810 RFC 3810: Multicast Listener Discovery Version 2 (MLDv2) for IPv6 * @since 1.7 */ diff --git a/src/java.base/share/classes/java/nio/charset/Charset.java b/src/java.base/share/classes/java/nio/charset/Charset.java index da62c13b881ef..62f258453ba97 100644 --- a/src/java.base/share/classes/java/nio/charset/Charset.java +++ b/src/java.base/share/classes/java/nio/charset/Charset.java @@ -263,6 +263,10 @@ * of chars) and sequences of bytes.

    * * + * @spec http://www.iana.org/assignments/character-sets Character Sets + * @spec https://www.rfc-editor.org/info/rfc2278 RFC 2278: IANA Charset Registration Procedures + * @spec https://www.rfc-editor.org/info/rfc2279 RFC 2279: UTF-8, a transformation format of ISO 10646 + * @spec https://www.rfc-editor.org/info/rfc2781 RFC 2781: UTF-16, an encoding of ISO 10646 * @author Mark Reinhold * @author JSR-51 Expert Group * @since 1.4 @@ -745,6 +749,7 @@ public String displayName() { * * @return {@code true} if, and only if, this charset is known by its * implementor to be registered with the IANA + * @spec http://www.iana.org/assignments/character-sets Character Sets */ public final boolean isRegistered() { return !name.startsWith("X-") && !name.startsWith("x-"); diff --git a/src/java.base/share/classes/java/nio/charset/package-info.java b/src/java.base/share/classes/java/nio/charset/package-info.java index 046606a57db75..14d1dea7fca43 100644 --- a/src/java.base/share/classes/java/nio/charset/package-info.java +++ b/src/java.base/share/classes/java/nio/charset/package-info.java @@ -88,6 +88,7 @@ * NullPointerException} to be thrown. * * + * @spec https://www.rfc-editor.org/info/rfc2278 RFC 2278: IANA Charset Registration Procedures * @since 1.4 * @author Mark Reinhold * @author JSR-51 Expert Group diff --git a/src/java.base/share/classes/java/nio/file/Files.java b/src/java.base/share/classes/java/nio/file/Files.java index 601dd99d461e5..3f619e272e5c5 100644 --- a/src/java.base/share/classes/java/nio/file/Files.java +++ b/src/java.base/share/classes/java/nio/file/Files.java @@ -1719,6 +1719,7 @@ private static List loadInstalledDetectors() { * @throws SecurityException * If a security manager is installed and it denies an unspecified * permission required by a file type detector implementation. + * @spec https://www.rfc-editor.org/info/rfc2045 RFC 2045: Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies */ public static String probeContentType(Path path) throws IOException diff --git a/src/java.base/share/classes/java/nio/file/attribute/AclEntry.java b/src/java.base/share/classes/java/nio/file/attribute/AclEntry.java index f2f8fdfcaa735..cf454578b9092 100644 --- a/src/java.base/share/classes/java/nio/file/attribute/AclEntry.java +++ b/src/java.base/share/classes/java/nio/file/attribute/AclEntry.java @@ -58,6 +58,7 @@ *

    ACL entries are immutable and are safe for use by multiple concurrent * threads. * + * @spec https://www.rfc-editor.org/info/rfc3530 RFC 3530: Network File System (NFS) version 4 Protocol * @since 1.7 */ diff --git a/src/java.base/share/classes/java/nio/file/attribute/AclEntryPermission.java b/src/java.base/share/classes/java/nio/file/attribute/AclEntryPermission.java index 492ab770d330b..424a6b5e9d86a 100644 --- a/src/java.base/share/classes/java/nio/file/attribute/AclEntryPermission.java +++ b/src/java.base/share/classes/java/nio/file/attribute/AclEntryPermission.java @@ -55,6 +55,7 @@ public enum AclEntryPermission { *

    RFC 3530: Network * File System (NFS) version 4 Protocol defines named attributes * as opaque files associated with a file in the file system. + * @spec https://www.rfc-editor.org/info/rfc3530 RFC 3530: Network File System (NFS) version 4 Protocol */ READ_NAMED_ATTRS, @@ -64,6 +65,7 @@ public enum AclEntryPermission { *

    RFC 3530: Network * File System (NFS) version 4 Protocol defines named attributes * as opaque files associated with a file in the file system. + * @spec https://www.rfc-editor.org/info/rfc3530 RFC 3530: Network File System (NFS) version 4 Protocol */ WRITE_NAMED_ATTRS, diff --git a/src/java.base/share/classes/java/nio/file/attribute/AclFileAttributeView.java b/src/java.base/share/classes/java/nio/file/attribute/AclFileAttributeView.java index 6db57e2fa50cd..6e87294faa131 100644 --- a/src/java.base/share/classes/java/nio/file/attribute/AclFileAttributeView.java +++ b/src/java.base/share/classes/java/nio/file/attribute/AclFileAttributeView.java @@ -139,6 +139,7 @@ * any attempt to create a file that would be less secure as a result of the * translation. * + * @spec https://www.rfc-editor.org/info/rfc3530 RFC 3530: Network File System (NFS) version 4 Protocol * @since 1.7 */ diff --git a/src/java.base/share/classes/java/nio/file/attribute/FileTime.java b/src/java.base/share/classes/java/nio/file/attribute/FileTime.java index 0ceb0fac0bbdd..ee2c3f9afa06d 100644 --- a/src/java.base/share/classes/java/nio/file/attribute/FileTime.java +++ b/src/java.base/share/classes/java/nio/file/attribute/FileTime.java @@ -409,6 +409,8 @@ private StringBuilder append(StringBuilder sb, int w, int d) { * are not present. The year before "{@code 0001}" is "{@code -0001}". * * @return the string representation of this file time + * @spec https://www.w3.org/TR/NOTE-datetime Date and Time Formats + * @spec https://www.w3.org/TR/xmlschema-2 XML Schema Part 2: Datatypes Second Edition */ @Override public String toString() { diff --git a/src/java.base/share/classes/java/nio/file/attribute/package-info.java b/src/java.base/share/classes/java/nio/file/attribute/package-info.java index 26c4c853d1370..57b399a83718b 100644 --- a/src/java.base/share/classes/java/nio/file/attribute/package-info.java +++ b/src/java.base/share/classes/java/nio/file/attribute/package-info.java @@ -124,6 +124,7 @@ * or method in any class or interface in this package will cause a {@link * java.lang.NullPointerException NullPointerException} to be thrown. * + * @spec https://www.rfc-editor.org/info/rfc3530 RFC 3530: Network File System (NFS) version 4 Protocol * @since 1.7 */ diff --git a/src/java.base/share/classes/java/nio/file/spi/FileTypeDetector.java b/src/java.base/share/classes/java/nio/file/spi/FileTypeDetector.java index 16da5e4ce6398..22be98594f017 100644 --- a/src/java.base/share/classes/java/nio/file/spi/FileTypeDetector.java +++ b/src/java.base/share/classes/java/nio/file/spi/FileTypeDetector.java @@ -100,6 +100,7 @@ protected FileTypeDetector() { * provider then the {@link SecurityManager#checkRead(String)} method * is invoked to check read access to the file. * + * @spec https://www.rfc-editor.org/info/rfc2045 RFC 2045: Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies * @see java.nio.file.Files#probeContentType */ public abstract String probeContentType(Path path) diff --git a/src/java.base/share/classes/java/security/Key.java b/src/java.base/share/classes/java/security/Key.java index 4ba26bf1034b5..b3815d298b2a6 100644 --- a/src/java.base/share/classes/java/security/Key.java +++ b/src/java.base/share/classes/java/security/Key.java @@ -86,6 +86,8 @@ * Security Appendix * of the Java Object Serialization Specification for more information. * + * @spec serialization/index.html Java Object Serialization Specification + * @spec https://www.rfc-editor.org/info/rfc5280 RFC 5280: Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile * @see PublicKey * @see PrivateKey * @see KeyPair diff --git a/src/java.base/share/classes/java/security/KeyRep.java b/src/java.base/share/classes/java/security/KeyRep.java index 0a82bf82ae013..fe454b634a8a9 100644 --- a/src/java.base/share/classes/java/security/KeyRep.java +++ b/src/java.base/share/classes/java/security/KeyRep.java @@ -44,6 +44,7 @@ * Security Appendix * of the Java Object Serialization Specification for more information. * + * @spec serialization/index.html Java Object Serialization Specification * @see Key * @see KeyFactory * @see javax.crypto.spec.SecretKeySpec diff --git a/src/java.base/share/classes/java/security/SecureRandom.java b/src/java.base/share/classes/java/security/SecureRandom.java index 14f1f35d4acd8..9201a8cf25006 100644 --- a/src/java.base/share/classes/java/security/SecureRandom.java +++ b/src/java.base/share/classes/java/security/SecureRandom.java @@ -126,6 +126,7 @@ *

    Thread safety

    * {@code SecureRandom} objects are safe for use by multiple concurrent threads. * + * @spec https://www.rfc-editor.org/info/rfc4086 RFC 4086: Randomness Requirements for Security * @implSpec * A {@code SecureRandom} service provider can advertise that it is thread-safe * by setting the * Java Security Standard Algorithm Names document * for information about standard CRL types. + * @spec security/standard-names.html Java Security Standard Algorithm Names */ protected CRL(String type) { this.type = type; diff --git a/src/java.base/share/classes/java/security/cert/CRLReason.java b/src/java.base/share/classes/java/security/cert/CRLReason.java index 2bc83f3356b29..49a5fb182060f 100644 --- a/src/java.base/share/classes/java/security/cert/CRLReason.java +++ b/src/java.base/share/classes/java/security/cert/CRLReason.java @@ -31,6 +31,7 @@ * RFC 5280: Internet X.509 Public Key Infrastructure Certificate and CRL * Profile. * + * @spec https://www.rfc-editor.org/info/rfc5280 RFC 5280: Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile * @author Sean Mullan * @since 1.7 * @see X509CRLEntry#getRevocationReason diff --git a/src/java.base/share/classes/java/security/cert/PKIXRevocationChecker.java b/src/java.base/share/classes/java/security/cert/PKIXRevocationChecker.java index d36fcafd3e062..dcc0839a02fc8 100644 --- a/src/java.base/share/classes/java/security/cert/PKIXRevocationChecker.java +++ b/src/java.base/share/classes/java/security/cert/PKIXRevocationChecker.java @@ -81,6 +81,8 @@ * necessary locking. Multiple threads each manipulating separate objects * need not synchronize. * + * @spec https://www.rfc-editor.org/info/rfc2560 RFC 2560: X.509 Internet Public Key Infrastructure Online Certificate Status Protocol - OCSP + * @spec https://www.rfc-editor.org/info/rfc5280 RFC 5280: Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile * @since 1.8 * * @see RFC 2560: X.509 diff --git a/src/java.base/share/classes/java/security/cert/TrustAnchor.java b/src/java.base/share/classes/java/security/cert/TrustAnchor.java index 2626bcf3c2ddd..3f58a9d60cc62 100644 --- a/src/java.base/share/classes/java/security/cert/TrustAnchor.java +++ b/src/java.base/share/classes/java/security/cert/TrustAnchor.java @@ -125,6 +125,7 @@ public class TrustAnchor { * decoded * @throws NullPointerException if the specified * {@code X509Certificate} is {@code null} + * @spec https://www.rfc-editor.org/info/rfc5280 RFC 5280: Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile */ public TrustAnchor(X509Certificate trustedCert, byte[] nameConstraints) { @@ -207,6 +208,7 @@ public TrustAnchor(X500Principal caPrincipal, PublicKey pubKey, * or incorrectly formatted or the name constraints cannot be decoded * @throws NullPointerException if the specified {@code caName} or * {@code pubKey} parameter is {@code null} + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names */ public TrustAnchor(String caName, PublicKey pubKey, byte[] nameConstraints) { diff --git a/src/java.base/share/classes/java/security/cert/X509CRL.java b/src/java.base/share/classes/java/security/cert/X509CRL.java index f014c9b82c8c8..ac9cf3b5dee8a 100644 --- a/src/java.base/share/classes/java/security/cert/X509CRL.java +++ b/src/java.base/share/classes/java/security/cert/X509CRL.java @@ -95,6 +95,7 @@ * } * } * + * @spec https://www.rfc-editor.org/info/rfc5280 RFC 5280: Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile * @author Hemma Prafullchandra * @since 1.2 * @@ -460,6 +461,7 @@ public X509CRLEntry getRevokedCertificate(X509Certificate certificate) { * relevant ASN.1 definitions. * * @return the signature algorithm OID string. + * @spec https://www.rfc-editor.org/info/rfc3279 RFC 3279: Algorithms and Identifiers for the Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile */ public abstract String getSigAlgOID(); diff --git a/src/java.base/share/classes/java/security/cert/X509CRLSelector.java b/src/java.base/share/classes/java/security/cert/X509CRLSelector.java index 337dcc6342ddb..d490d51ce6104 100644 --- a/src/java.base/share/classes/java/security/cert/X509CRLSelector.java +++ b/src/java.base/share/classes/java/security/cert/X509CRLSelector.java @@ -65,6 +65,7 @@ * provide the necessary locking. Multiple threads each manipulating * separate objects need not synchronize. * + * @spec https://www.rfc-editor.org/info/rfc5280 RFC 5280: Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile * @see CRLSelector * @see X509CRL * @@ -193,6 +194,7 @@ public void setIssuers(Collection issuers) { * * @param names a {@code Collection} of names (or {@code null}) * @throws IOException if a parsing error occurs + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names * @see #getIssuerNames */ public void setIssuerNames(Collection names) throws IOException { @@ -238,6 +240,7 @@ public void addIssuer(X500Principal issuer) { * RFC 2253 form * @throws IOException if a parsing error occurs * + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names * @deprecated Use {@link #addIssuer(X500Principal)} or * {@link #addIssuerName(byte[])} instead. This method should not be * relied on as it can fail to match some CRLs because of a loss of @@ -493,6 +496,7 @@ public Collection getIssuers() { * protect against subsequent modifications. * * @return a {@code Collection} of names (or {@code null}) + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names * @see #setIssuerNames */ public Collection getIssuerNames() { diff --git a/src/java.base/share/classes/java/security/cert/X509CertSelector.java b/src/java.base/share/classes/java/security/cert/X509CertSelector.java index c472d58b473f6..ae48af4a9d902 100644 --- a/src/java.base/share/classes/java/security/cert/X509CertSelector.java +++ b/src/java.base/share/classes/java/security/cert/X509CertSelector.java @@ -74,6 +74,7 @@ * provide the necessary locking. Multiple threads each manipulating * separate objects need not synchronize. * + * @spec https://www.rfc-editor.org/info/rfc5280 RFC 5280: Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile * @see CertSelector * @see X509Certificate * @@ -198,6 +199,7 @@ public void setIssuer(X500Principal issuer) { * (or {@code null}) * @throws IOException if a parsing error occurs (incorrect form for DN) * + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names * @deprecated Use {@link #setIssuer(X500Principal)} or * {@link #setIssuer(byte[])} instead. This method should not be relied on * as it can fail to match some certificates because of a loss of encoding @@ -290,6 +292,7 @@ public void setSubject(X500Principal subject) { * (or {@code null}) * @throws IOException if a parsing error occurs (incorrect form for DN) * + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names * @deprecated Use {@link #setSubject(X500Principal)} or * {@link #setSubject(byte[])} instead. This method should not be relied * on as it can fail to match some certificates because of a loss of @@ -732,6 +735,8 @@ public void setSubjectAlternativeNames(Collection> names) * RFC 5280, section 4.2.1.6) * @param name the name in string form (not {@code null}) * @throws IOException if a parsing error occurs + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names + * @spec https://www.rfc-editor.org/info/rfc822 RFC 822: STANDARD FOR THE FORMAT OF ARPA INTERNET TEXT MESSAGES */ public void addSubjectAlternativeName(int type, String name) throws IOException { @@ -1281,6 +1286,7 @@ public X500Principal getIssuer() { * @return the required issuer distinguished name in RFC 2253 format * (or {@code null}) * + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names * @deprecated Use {@link #getIssuer()} or {@link #getIssuerAsBytes()} * instead. This method should not be relied on as it can fail to match * some certificates because of a loss of encoding information in the @@ -1340,6 +1346,7 @@ public X500Principal getSubject() { * @return the required subject distinguished name in RFC 2253 format * (or {@code null}) * + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names * @deprecated Use {@link #getSubject()} or {@link #getSubjectAsBytes()} * instead. This method should not be relied on as it can fail to match * some certificates because of a loss of encoding information in the diff --git a/src/java.base/share/classes/java/security/cert/X509Certificate.java b/src/java.base/share/classes/java/security/cert/X509Certificate.java index 22f2423145dbc..29506d3f5b636 100644 --- a/src/java.base/share/classes/java/security/cert/X509Certificate.java +++ b/src/java.base/share/classes/java/security/cert/X509Certificate.java @@ -95,6 +95,7 @@ * } * * + * @spec https://www.rfc-editor.org/info/rfc5280 RFC 5280: Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile * @author Hemma Prafullchandra * @since 1.2 * @@ -386,6 +387,7 @@ public abstract byte[] getTBSCertificate() * relevant ASN.1 definitions. * * @return the signature algorithm OID string. + * @spec https://www.rfc-editor.org/info/rfc3279 RFC 3279: Algorithms and Identifiers for the Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile */ public abstract String getSigAlgOID(); @@ -608,6 +610,8 @@ public List getExtendedKeyUsage() throws CertificateParsingException { * and it provides a default implementation. Subclasses * should override this method with a correct implementation. * + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names + * @spec https://www.rfc-editor.org/info/rfc822 RFC 822: STANDARD FOR THE FORMAT OF ARPA INTERNET TEXT MESSAGES * @implNote The JDK SUN provider supports the third and fourth * otherName entries. * diff --git a/src/java.base/share/classes/java/security/cert/package-info.java b/src/java.base/share/classes/java/security/cert/package-info.java index 0a5f0b7b532bc..6adfb0c137344 100644 --- a/src/java.base/share/classes/java/security/cert/package-info.java +++ b/src/java.base/share/classes/java/security/cert/package-info.java @@ -52,6 +52,8 @@ *
  • {@extLink security_guide_pki Java PKI Programmer's Guide} * * + * @spec security/standard-names.html Java Security Standard Algorithm Names + * @spec https://www.rfc-editor.org/info/rfc5280 RFC 5280: Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile * @since 1.2 */ package java.security.cert; diff --git a/src/java.base/share/classes/java/security/interfaces/EdECKey.java b/src/java.base/share/classes/java/security/interfaces/EdECKey.java index bec29eeed8e93..a6ee38284c60e 100644 --- a/src/java.base/share/classes/java/security/interfaces/EdECKey.java +++ b/src/java.base/share/classes/java/security/interfaces/EdECKey.java @@ -35,6 +35,7 @@ * This interface allows access to the algorithm parameters associated with * the key. * + * @spec https://www.rfc-editor.org/info/rfc8032 RFC 8032: Edwards-Curve Digital Signature Algorithm (EdDSA) * @since 15 */ public interface EdECKey { diff --git a/src/java.base/share/classes/java/security/interfaces/EdECPrivateKey.java b/src/java.base/share/classes/java/security/interfaces/EdECPrivateKey.java index 826b52650eaf4..e705d15cd625b 100644 --- a/src/java.base/share/classes/java/security/interfaces/EdECPrivateKey.java +++ b/src/java.base/share/classes/java/security/interfaces/EdECPrivateKey.java @@ -39,6 +39,7 @@ * string lengths that are a multiple of 8, and the key is represented using * a byte array. * + * @spec https://www.rfc-editor.org/info/rfc8032 RFC 8032: Edwards-Curve Digital Signature Algorithm (EdDSA) * @since 15 */ public interface EdECPrivateKey extends EdECKey, PrivateKey { diff --git a/src/java.base/share/classes/java/security/interfaces/EdECPublicKey.java b/src/java.base/share/classes/java/security/interfaces/EdECPublicKey.java index d2e2641165122..54be0a639c9cc 100644 --- a/src/java.base/share/classes/java/security/interfaces/EdECPublicKey.java +++ b/src/java.base/share/classes/java/security/interfaces/EdECPublicKey.java @@ -37,6 +37,7 @@ * An Edwards-Curve public key is a point on the curve, which is represented using an * EdECPoint. * + * @spec https://www.rfc-editor.org/info/rfc8032 RFC 8032: Edwards-Curve Digital Signature Algorithm (EdDSA) * @since 15 */ public interface EdECPublicKey extends EdECKey, PublicKey { diff --git a/src/java.base/share/classes/java/security/interfaces/RSAKey.java b/src/java.base/share/classes/java/security/interfaces/RSAKey.java index f28a76869db99..31d78b9e25a26 100644 --- a/src/java.base/share/classes/java/security/interfaces/RSAKey.java +++ b/src/java.base/share/classes/java/security/interfaces/RSAKey.java @@ -33,6 +33,7 @@ * PKCS#1 v2.2 standard, * such as those for RSA, or RSASSA-PSS algorithms. * + * @spec https://www.rfc-editor.org/info/rfc8017 RFC 8017: PKCS #1: RSA Cryptography Specifications Version 2.2 * @author Jan Luehe * * @see RSAPublicKey diff --git a/src/java.base/share/classes/java/security/interfaces/RSAMultiPrimePrivateCrtKey.java b/src/java.base/share/classes/java/security/interfaces/RSAMultiPrimePrivateCrtKey.java index 079130e5fb5f9..fa90bdd9231a5 100644 --- a/src/java.base/share/classes/java/security/interfaces/RSAMultiPrimePrivateCrtKey.java +++ b/src/java.base/share/classes/java/security/interfaces/RSAMultiPrimePrivateCrtKey.java @@ -33,6 +33,7 @@ * PKCS#1 v2.2 standard, * using the Chinese Remainder Theorem (CRT) information values. * + * @spec https://www.rfc-editor.org/info/rfc8017 RFC 8017: PKCS #1: RSA Cryptography Specifications Version 2.2 * @author Valerie Peng * * diff --git a/src/java.base/share/classes/java/security/interfaces/RSAPrivateCrtKey.java b/src/java.base/share/classes/java/security/interfaces/RSAPrivateCrtKey.java index 1b2bed7f9c1bc..33257fc3457ff 100644 --- a/src/java.base/share/classes/java/security/interfaces/RSAPrivateCrtKey.java +++ b/src/java.base/share/classes/java/security/interfaces/RSAPrivateCrtKey.java @@ -32,6 +32,7 @@ * PKCS#1 v2.2 standard, * using the Chinese Remainder Theorem (CRT) information values. * + * @spec https://www.rfc-editor.org/info/rfc8017 RFC 8017: PKCS #1: RSA Cryptography Specifications Version 2.2 * @author Jan Luehe * @since 1.2 * diff --git a/src/java.base/share/classes/java/security/package-info.java b/src/java.base/share/classes/java/security/package-info.java index ecbf629cbd912..1f60945a3c5f3 100644 --- a/src/java.base/share/classes/java/security/package-info.java +++ b/src/java.base/share/classes/java/security/package-info.java @@ -79,6 +79,7 @@ * * * + * @spec security/standard-names.html Java Security Standard Algorithm Names * @since 1.1 */ package java.security; diff --git a/src/java.base/share/classes/java/security/spec/EdDSAParameterSpec.java b/src/java.base/share/classes/java/security/spec/EdDSAParameterSpec.java index 673e9377b1408..b2f31175bd1dc 100644 --- a/src/java.base/share/classes/java/security/spec/EdDSAParameterSpec.java +++ b/src/java.base/share/classes/java/security/spec/EdDSAParameterSpec.java @@ -41,6 +41,7 @@ *
  • Otherwise, the mode is Ed25519 or Ed448
    • * * + * @spec https://www.rfc-editor.org/info/rfc8032 RFC 8032: Edwards-Curve Digital Signature Algorithm (EdDSA) * @since 15 */ diff --git a/src/java.base/share/classes/java/security/spec/EdECPoint.java b/src/java.base/share/classes/java/security/spec/EdECPoint.java index cb080f8557d3d..23ffd9ec43f8c 100644 --- a/src/java.base/share/classes/java/security/spec/EdECPoint.java +++ b/src/java.base/share/classes/java/security/spec/EdECPoint.java @@ -42,6 +42,7 @@ * {@code BigInteger}, and implementations that consume objects of this class * may reject integer values which are not in the range [0, p). * + * @spec https://www.rfc-editor.org/info/rfc8032 RFC 8032: Edwards-Curve Digital Signature Algorithm (EdDSA) * @since 15 */ diff --git a/src/java.base/share/classes/java/security/spec/EdECPrivateKeySpec.java b/src/java.base/share/classes/java/security/spec/EdECPrivateKeySpec.java index 370dfc92e5903..308656f4efc2c 100644 --- a/src/java.base/share/classes/java/security/spec/EdECPrivateKeySpec.java +++ b/src/java.base/share/classes/java/security/spec/EdECPrivateKeySpec.java @@ -34,6 +34,7 @@ * a byte array. This class only supports bit string lengths that are a * multiple of 8. * + * @spec https://www.rfc-editor.org/info/rfc8032 RFC 8032: Edwards-Curve Digital Signature Algorithm (EdDSA) * @since 15 */ public final class EdECPrivateKeySpec implements KeySpec { diff --git a/src/java.base/share/classes/java/security/spec/EdECPublicKeySpec.java b/src/java.base/share/classes/java/security/spec/EdECPublicKeySpec.java index fc52b3b7968e3..a2d276d6d945e 100644 --- a/src/java.base/share/classes/java/security/spec/EdECPublicKeySpec.java +++ b/src/java.base/share/classes/java/security/spec/EdECPublicKeySpec.java @@ -33,6 +33,7 @@ * algorithm parameters. The public key is a point on the curve, which is * represented using an {@code EdECPoint}. * + * @spec https://www.rfc-editor.org/info/rfc8032 RFC 8032: Edwards-Curve Digital Signature Algorithm (EdDSA) * @since 15 */ public final class EdECPublicKeySpec implements KeySpec { diff --git a/src/java.base/share/classes/java/security/spec/MGF1ParameterSpec.java b/src/java.base/share/classes/java/security/spec/MGF1ParameterSpec.java index 64e8801501588..d18ec4ebfc3e7 100644 --- a/src/java.base/share/classes/java/security/spec/MGF1ParameterSpec.java +++ b/src/java.base/share/classes/java/security/spec/MGF1ParameterSpec.java @@ -55,6 +55,7 @@ * ... -- Allows for future expansion -- * } * + * @spec https://www.rfc-editor.org/info/rfc8017 RFC 8017: PKCS #1: RSA Cryptography Specifications Version 2.2 * @see PSSParameterSpec * @see javax.crypto.spec.OAEPParameterSpec * diff --git a/src/java.base/share/classes/java/security/spec/PSSParameterSpec.java b/src/java.base/share/classes/java/security/spec/PSSParameterSpec.java index d6f051995998f..352ebea6d5120 100644 --- a/src/java.base/share/classes/java/security/spec/PSSParameterSpec.java +++ b/src/java.base/share/classes/java/security/spec/PSSParameterSpec.java @@ -65,6 +65,7 @@ * } * * + * @spec https://www.rfc-editor.org/info/rfc8017 RFC 8017: PKCS #1: RSA Cryptography Specifications Version 2.2 * @see MGF1ParameterSpec * @see AlgorithmParameterSpec * @see java.security.Signature @@ -96,6 +97,7 @@ public class PSSParameterSpec implements AlgorithmParameterSpec { /** * The PSS parameter set with all default values. + * @spec https://www.rfc-editor.org/info/rfc8017 RFC 8017: PKCS #1: RSA Cryptography Specifications Version 2.2 * @deprecated This field uses the default values defined in the PKCS #1 * standard. Some of these defaults are no longer recommended due * to advances in cryptanalysis -- see the @@ -159,6 +161,7 @@ public PSSParameterSpec(String mdName, String mgfName, * @param saltLen the length of salt in bytes * @throws IllegalArgumentException if {@code saltLen} is * less than 0 + * @spec https://www.rfc-editor.org/info/rfc8017 RFC 8017: PKCS #1: RSA Cryptography Specifications Version 2.2 * @deprecated This constructor uses the default values defined in * the PKCS #1 standard except for the salt length. Some of these * defaults are no longer recommended due to advances in diff --git a/src/java.base/share/classes/java/security/spec/RSAMultiPrimePrivateCrtKeySpec.java b/src/java.base/share/classes/java/security/spec/RSAMultiPrimePrivateCrtKeySpec.java index cdb55b97418e9..98b74cd77af13 100644 --- a/src/java.base/share/classes/java/security/spec/RSAMultiPrimePrivateCrtKeySpec.java +++ b/src/java.base/share/classes/java/security/spec/RSAMultiPrimePrivateCrtKeySpec.java @@ -34,6 +34,7 @@ * using the Chinese Remainder Theorem (CRT) information values * for efficiency. * + * @spec https://www.rfc-editor.org/info/rfc8017 RFC 8017: PKCS #1: RSA Cryptography Specifications Version 2.2 * @author Valerie Peng * * diff --git a/src/java.base/share/classes/java/security/spec/RSAOtherPrimeInfo.java b/src/java.base/share/classes/java/security/spec/RSAOtherPrimeInfo.java index b434075c6834e..d4e0e96ce2735 100644 --- a/src/java.base/share/classes/java/security/spec/RSAOtherPrimeInfo.java +++ b/src/java.base/share/classes/java/security/spec/RSAOtherPrimeInfo.java @@ -42,6 +42,7 @@ * * * + * @spec https://www.rfc-editor.org/info/rfc8017 RFC 8017: PKCS #1: RSA Cryptography Specifications Version 2.2 * @author Valerie Peng * * diff --git a/src/java.base/share/classes/java/security/spec/RSAPrivateCrtKeySpec.java b/src/java.base/share/classes/java/security/spec/RSAPrivateCrtKeySpec.java index c8bed964b0eb9..14a84b39eb4cb 100644 --- a/src/java.base/share/classes/java/security/spec/RSAPrivateCrtKeySpec.java +++ b/src/java.base/share/classes/java/security/spec/RSAPrivateCrtKeySpec.java @@ -32,6 +32,7 @@ * PKCS#1 v2.2 standard, * using the Chinese Remainder Theorem (CRT) information values for efficiency. * + * @spec https://www.rfc-editor.org/info/rfc8017 RFC 8017: PKCS #1: RSA Cryptography Specifications Version 2.2 * @author Jan Luehe * @since 1.2 * diff --git a/src/java.base/share/classes/java/text/Collator.java b/src/java.base/share/classes/java/text/Collator.java index f011dbdccf373..a07d237f89eec 100644 --- a/src/java.base/share/classes/java/text/Collator.java +++ b/src/java.base/share/classes/java/text/Collator.java @@ -191,6 +191,7 @@ public abstract class Collator * described in * Unicode * Standard Annex #15: Unicode Normalization Forms. + * @spec https://www.unicode.org/reports/tr15 Unicode Normalization Forms * @see java.text.Collator#getDecomposition * @see java.text.Collator#setDecomposition */ @@ -210,6 +211,7 @@ public abstract class Collator * described in * Unicode * Standard Annex #15: Unicode Normalization Forms. + * @spec https://www.unicode.org/reports/tr15 Unicode Normalization Forms * @see java.text.Collator#getDecomposition * @see java.text.Collator#setDecomposition */ diff --git a/src/java.base/share/classes/java/text/CompactNumberFormat.java b/src/java.base/share/classes/java/text/CompactNumberFormat.java index 30a1bf4be6379..9bf2b71340348 100644 --- a/src/java.base/share/classes/java/text/CompactNumberFormat.java +++ b/src/java.base/share/classes/java/text/CompactNumberFormat.java @@ -205,6 +205,7 @@ * {@link java.math.RoundingMode} for formatting. By default, it uses * {@link java.math.RoundingMode#HALF_EVEN RoundingMode.HALF_EVEN}. * + * @spec https://www.unicode.org/reports/tr35 Unicode Locale Data Markup Language (LDML) * @see NumberFormat.Style * @see NumberFormat * @see DecimalFormat @@ -425,6 +426,7 @@ public CompactNumberFormat(String decimalPattern, * the {@code compactPatterns} array contains an invalid pattern, * a {@code null} appears in the array of compact patterns, * or if the given {@code pluralRules} contains an invalid syntax + * @spec https://www.unicode.org/reports/tr35 Unicode Locale Data Markup Language (LDML) * @see DecimalFormat#DecimalFormat(java.lang.String, DecimalFormatSymbols) * @see DecimalFormatSymbols * @since 14 diff --git a/src/java.base/share/classes/java/text/DateFormatSymbols.java b/src/java.base/share/classes/java/text/DateFormatSymbols.java index f621b1d115c8d..b6f0837ebbf7c 100644 --- a/src/java.base/share/classes/java/text/DateFormatSymbols.java +++ b/src/java.base/share/classes/java/text/DateFormatSymbols.java @@ -412,6 +412,7 @@ public void setEras(String[] newEras) { * Calendar Elements in the Unicode Locale Data Markup Language * (LDML) specification for more details. * + * @spec https://www.unicode.org/reports/tr35 Unicode Locale Data Markup Language (LDML) * @implSpec This method returns 13 elements since * {@link java.util.Calendar#UNDECIMBER Calendar.UNDECIMBER} is supported. * @return the month strings. @@ -450,6 +451,7 @@ public void setMonths(String[] newMonths) { * Calendar Elements in the Unicode Locale Data Markup Language * (LDML) specification for more details. * + * @spec https://www.unicode.org/reports/tr35 Unicode Locale Data Markup Language (LDML) * @implSpec This method returns 13 elements since * {@link java.util.Calendar#UNDECIMBER Calendar.UNDECIMBER} is supported. * @return the short month strings. diff --git a/src/java.base/share/classes/java/text/Normalizer.java b/src/java.base/share/classes/java/text/Normalizer.java index 00317e768fd37..5265fefc67106 100644 --- a/src/java.base/share/classes/java/text/Normalizer.java +++ b/src/java.base/share/classes/java/text/Normalizer.java @@ -103,6 +103,7 @@ * character encodings the Unicode text needs to be normalized to NFC. * For more usage examples, see the Unicode Standard Annex. * + * @spec https://www.unicode.org/reports/tr15 Unicode Normalization Forms * @since 1.6 */ public final class Normalizer { @@ -116,6 +117,7 @@ public final class Normalizer { * Unicode Standard Annex #15 — Unicode Normalization Forms * and two methods to access them. * + * @spec https://www.unicode.org/reports/tr15 Unicode Normalization Forms * @since 1.6 */ public static enum Form { diff --git a/src/java.base/share/classes/java/text/NumberFormat.java b/src/java.base/share/classes/java/text/NumberFormat.java index 18c078f1a4e4e..898ab9f0dcb8e 100644 --- a/src/java.base/share/classes/java/text/NumberFormat.java +++ b/src/java.base/share/classes/java/text/NumberFormat.java @@ -586,6 +586,7 @@ public static final NumberFormat getCurrencyInstance() { * * @param inLocale the desired locale * @return the {@code NumberFormat} instance for currency formatting + * @spec https://www.unicode.org/reports/tr35 Unicode Locale Data Markup Language (LDML) */ public static NumberFormat getCurrencyInstance(Locale inLocale) { return getInstance(inLocale, null, CURRENCYSTYLE); diff --git a/src/java.base/share/classes/java/time/format/DateTimeFormatter.java b/src/java.base/share/classes/java/time/format/DateTimeFormatter.java index d5a5c162fd2de..9192a83603ae0 100644 --- a/src/java.base/share/classes/java/time/format/DateTimeFormatter.java +++ b/src/java.base/share/classes/java/time/format/DateTimeFormatter.java @@ -760,6 +760,7 @@ public static DateTimeFormatter ofLocalizedDateTime(FormatStyle dateStyle, Forma * @param requestedTemplate the requested template, not null * @return the formatter based on the {@code requestedTemplate} pattern, not null * @throws IllegalArgumentException if {@code requestedTemplate} is invalid + * @spec https://www.unicode.org/reports/tr35 Unicode Locale Data Markup Language (LDML) * @see #ofPattern(String) * @since 19 */ diff --git a/src/java.base/share/classes/java/time/format/DateTimeFormatterBuilder.java b/src/java.base/share/classes/java/time/format/DateTimeFormatterBuilder.java index d45bfa03f9181..a6ae37d82803b 100644 --- a/src/java.base/share/classes/java/time/format/DateTimeFormatterBuilder.java +++ b/src/java.base/share/classes/java/time/format/DateTimeFormatterBuilder.java @@ -1525,6 +1525,7 @@ public DateTimeFormatterBuilder appendLocalized(FormatStyle dateStyle, FormatSty * @param requestedTemplate the requested template to use, not null * @return this, for chaining, not null * @throws IllegalArgumentException if {@code requestedTemplate} is invalid + * @spec https://www.unicode.org/reports/tr35 Unicode Locale Data Markup Language (LDML) * @see #appendPattern(String) * @since 19 */ @@ -1608,6 +1609,7 @@ public DateTimeFormatterBuilder appendLiteral(String literal) { * * @param style the text style to use, not null * @return this, for chaining, not null + * @spec https://www.unicode.org/reports/tr35 Unicode Locale Data Markup Language (LDML) * @since 16 */ public DateTimeFormatterBuilder appendDayPeriodText(TextStyle style) { diff --git a/src/java.base/share/classes/java/util/Base64.java b/src/java.base/share/classes/java/util/Base64.java index d15b3842b3c9f..c91ac6ecc99cb 100644 --- a/src/java.base/share/classes/java/util/Base64.java +++ b/src/java.base/share/classes/java/util/Base64.java @@ -73,6 +73,8 @@ * method of this class will cause a {@link java.lang.NullPointerException * NullPointerException} to be thrown. * + * @spec https://www.rfc-editor.org/info/rfc2045 RFC 2045: Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies + * @spec https://www.rfc-editor.org/info/rfc4648 RFC 4648: The Base16, Base32, and Base64 Data Encodings * @author Xueming Shen * @since 1.8 */ diff --git a/src/java.base/share/classes/java/util/Currency.java b/src/java.base/share/classes/java/util/Currency.java index 59b44afed06f9..77d74e2e4f9ed 100644 --- a/src/java.base/share/classes/java/util/Currency.java +++ b/src/java.base/share/classes/java/util/Currency.java @@ -108,6 +108,7 @@ * with {@code Currency} or monetary values as it provides better handling of floating * point numbers and their operations. * + * @spec http://www.iso.org/iso/home/standards/currency_codes.htm ISO - ISO 4217 - Currency codes * @see java.math.BigDecimal * @since 1.4 */ diff --git a/src/java.base/share/classes/java/util/Formatter.java b/src/java.base/share/classes/java/util/Formatter.java index 5c5859c767dc3..6379da0ade5bc 100644 --- a/src/java.base/share/classes/java/util/Formatter.java +++ b/src/java.base/share/classes/java/util/Formatter.java @@ -2004,6 +2004,8 @@ * method or constructor in this class will cause a {@link * NullPointerException} to be thrown. * + * @spec https://www.w3.org/TR/NOTE-datetime Date and Time Formats + * @spec https://www.rfc-editor.org/info/rfc822 RFC 822: STANDARD FOR THE FORMAT OF ARPA INTERNET TEXT MESSAGES * @author Iris Clark * @since 1.5 */ diff --git a/src/java.base/share/classes/java/util/Locale.java b/src/java.base/share/classes/java/util/Locale.java index 438cd9e1cbc3e..63caf79f467ea 100644 --- a/src/java.base/share/classes/java/util/Locale.java +++ b/src/java.base/share/classes/java/util/Locale.java @@ -469,6 +469,8 @@ * compatibility, the implementation still does not impose a length * constraint. * + * @spec https://www.rfc-editor.org/info/rfc4647 RFC 4647: Matching of Language Tags + * @spec https://www.rfc-editor.org/info/rfc5646 RFC 5646: Tags for Identifying Languages * @see Builder * @see ResourceBundle * @see java.text.Format @@ -3020,6 +3022,7 @@ public Locale build() { * * * + * @spec https://www.rfc-editor.org/info/rfc4647 RFC 4647: Matching of Language Tags * @see #filter(List, Collection, FilteringMode) * @see #filterTags(List, Collection, FilteringMode) * @@ -3091,6 +3094,8 @@ public static enum FilteringMode { * {@code "zh-Hant-*"} (Traditional Chinese, any regions) are extended * language ranges. * + * @spec https://www.rfc-editor.org/info/rfc4234 RFC 4234: Augmented BNF for Syntax Specifications: ABNF + * @spec https://www.rfc-editor.org/info/rfc4647 RFC 4647: Matching of Language Tags * @see #filter * @see #filterTags * @see #lookup @@ -3287,6 +3292,7 @@ public double getWeight() { * @throws NullPointerException if {@code ranges} is null * @throws IllegalArgumentException if a language range or a weight * found in the given {@code ranges} is ill-formed + * @spec https://www.rfc-editor.org/info/rfc2616 RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1 */ public static List parse(String ranges) { return LocaleMatcher.parse(ranges); @@ -3308,6 +3314,7 @@ public static List parse(String ranges) { * @throws NullPointerException if {@code ranges} is null * @throws IllegalArgumentException if a language range or a weight * found in the given {@code ranges} is ill-formed + * @spec https://www.rfc-editor.org/info/rfc2616 RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1 * @see #parse(String) * @see #mapEquivalents */ diff --git a/src/java.base/share/classes/java/util/Properties.java b/src/java.base/share/classes/java/util/Properties.java index c4136ff56fd17..5e10ad53d00e4 100644 --- a/src/java.base/share/classes/java/util/Properties.java +++ b/src/java.base/share/classes/java/util/Properties.java @@ -986,6 +986,7 @@ private static void writeDateComment(BufferedWriter bw) throws IOException { * @throws InvalidPropertiesFormatException Data on input stream does not * constitute a valid XML document with the mandated document type. * @throws NullPointerException if {@code in} is null. + * @spec https://www.w3.org/TR/xml Extensible Markup Language (XML) 1.0 (Fifth Edition) * @see #storeToXML(OutputStream, String, String) * @see Character * Encoding in Entities @@ -1064,6 +1065,7 @@ public void storeToXML(OutputStream os, String comment) * or if {@code encoding} is {@code null}. * @throws ClassCastException if this {@code Properties} object * contains any keys or values that are not {@code Strings}. + * @spec https://www.w3.org/TR/xml Extensible Markup Language (XML) 1.0 (Fifth Edition) * @see #loadFromXML(InputStream) * @see Character * Encoding in Entities @@ -1113,6 +1115,7 @@ public void storeToXML(OutputStream os, String comment, String encoding) * @throws NullPointerException if {@code os} or {@code charset} is {@code null}. * @throws ClassCastException if this {@code Properties} object * contains any keys or values that are not {@code Strings}. + * @spec https://www.w3.org/TR/xml Extensible Markup Language (XML) 1.0 (Fifth Edition) * @see #loadFromXML(InputStream) * @see Character * Encoding in Entities diff --git a/src/java.base/share/classes/java/util/UUID.java b/src/java.base/share/classes/java/util/UUID.java index ffeab49a0b110..85d4738e23f95 100644 --- a/src/java.base/share/classes/java/util/UUID.java +++ b/src/java.base/share/classes/java/util/UUID.java @@ -68,6 +68,7 @@ * Universally Unique IDentifier (UUID) URN Namespace, section 4.2 * "Algorithms for Creating a Time-Based UUID". * + * @spec https://www.rfc-editor.org/info/rfc4122 RFC 4122: A Universally Unique IDentifier (UUID) URN Namespace * @since 1.5 */ public final class UUID implements java.io.Serializable, Comparable { @@ -345,6 +346,7 @@ public int version() { * * * @return The variant number of this {@code UUID} + * @spec https://www.rfc-editor.org/info/rfc4122 RFC 4122: A Universally Unique IDentifier (UUID) URN Namespace */ public int variant() { // This field is composed of a varying number of bits. diff --git a/src/java.base/share/classes/java/util/jar/Attributes.java b/src/java.base/share/classes/java/util/jar/Attributes.java index 3e6e67345405c..120343ca5cdac 100644 --- a/src/java.base/share/classes/java/util/jar/Attributes.java +++ b/src/java.base/share/classes/java/util/jar/Attributes.java @@ -55,6 +55,7 @@ *

    This map and its views have a predictable iteration order, namely the * order that keys were inserted into the map, as with {@link LinkedHashMap}. * + * @spec jar/jar.html JAR File Specification * @author David Connelly * @see Manifest * @since 1.2 @@ -446,6 +447,7 @@ int read(Manifest.FastInputStream is, byte[] lbuf, String filename, int lineNumb * and will be UTF8-encoded when written to the output stream. See the * JAR File Specification * for more information about valid attribute names and values. + * @spec jar/jar.html JAR File Specification */ public static class Name { private final String name; diff --git a/src/java.base/share/classes/java/util/jar/Manifest.java b/src/java.base/share/classes/java/util/jar/Manifest.java index 887db244f215e..ddc76eed9d1e5 100644 --- a/src/java.base/share/classes/java/util/jar/Manifest.java +++ b/src/java.base/share/classes/java/util/jar/Manifest.java @@ -44,6 +44,7 @@ * * Manifest format specification. * + * @spec jar/jar.html JAR File Specification * @author David Connelly * @see Attributes * @since 1.2 diff --git a/src/java.base/share/classes/java/util/jar/package-info.java b/src/java.base/share/classes/java/util/jar/package-info.java index 4ebf8d36998c6..255bbe835daa2 100644 --- a/src/java.base/share/classes/java/util/jar/package-info.java +++ b/src/java.base/share/classes/java/util/jar/package-info.java @@ -44,6 +44,7 @@ * Manifest and Signature Specification - The manifest format specification. * * + * @spec jar/jar.html JAR File Specification * @since 1.2 */ package java.util.jar; diff --git a/src/java.base/share/classes/java/util/regex/Pattern.java b/src/java.base/share/classes/java/util/regex/Pattern.java index 588665a0acf69..380273bc9e607 100644 --- a/src/java.base/share/classes/java/util/regex/Pattern.java +++ b/src/java.base/share/classes/java/util/regex/Pattern.java @@ -784,6 +784,7 @@ * O'Reilly and Associates, 2006. *

    * + * @spec https://www.unicode.org/reports/tr18 Unicode Regular Expressions * @see java.lang.String#split(String, int) * @see java.lang.String#split(String) * @@ -938,6 +939,7 @@ public final class Pattern * folding. *

    * Specifying this flag may impose a performance penalty.

    + * @spec https://www.unicode.org/reports/tr18 Unicode Regular Expressions * @since 1.7 */ public static final int UNICODE_CHARACTER_CLASS = 0x100; diff --git a/src/java.base/share/classes/java/util/spi/TimeZoneNameProvider.java b/src/java.base/share/classes/java/util/spi/TimeZoneNameProvider.java index 1febca22a280c..a6256bf35291c 100644 --- a/src/java.base/share/classes/java/util/spi/TimeZoneNameProvider.java +++ b/src/java.base/share/classes/java/util/spi/TimeZoneNameProvider.java @@ -74,6 +74,7 @@ protected TimeZoneNameProvider() { * getAvailableLocales()}. * @throws NullPointerException if {@code ID} or {@code locale} * is null + * @spec https://www.iana.org/time-zones Time Zone Database * @see java.util.TimeZone#getDisplayName(boolean, int, java.util.Locale) */ public abstract String getDisplayName(String ID, boolean daylight, int style, Locale locale); diff --git a/src/java.base/share/classes/java/util/zip/CRC32C.java b/src/java.base/share/classes/java/util/zip/CRC32C.java index a8b4d1b75659d..a4ebf005b3749 100644 --- a/src/java.base/share/classes/java/util/zip/CRC32C.java +++ b/src/java.base/share/classes/java/util/zip/CRC32C.java @@ -46,6 +46,7 @@ * {@link NullPointerException} to be thrown. *

    * + * @spec https://www.rfc-editor.org/info/rfc3720 RFC 3720: Internet Small Computer Systems Interface (iSCSI) * @since 9 */ public final class CRC32C implements Checksum { diff --git a/src/java.base/share/classes/java/util/zip/package-info.java b/src/java.base/share/classes/java/util/zip/package-info.java index 8f46fdb9edb75..10c161829a502 100644 --- a/src/java.base/share/classes/java/util/zip/package-info.java +++ b/src/java.base/share/classes/java/util/zip/package-info.java @@ -72,6 +72,10 @@ *
  • Adler-32 checksum is described in RFC 1950 (above) * * + * @spec https://www.rfc-editor.org/info/rfc1950 RFC 1950: ZLIB Compressed Data Format Specification version 3.3 + * @spec https://www.rfc-editor.org/info/rfc1951 RFC 1951: DEFLATE Compressed Data Format Specification version 1.3 + * @spec https://www.rfc-editor.org/info/rfc1952 RFC 1952: GZIP file format specification version 4.3 + * @spec https://www.rfc-editor.org/info/rfc3720 RFC 3720: Internet Small Computer Systems Interface (iSCSI) * @since 1.1 */ package java.util.zip; diff --git a/src/java.base/share/classes/javax/crypto/Cipher.java b/src/java.base/share/classes/javax/crypto/Cipher.java index 2eb2ffe14a4aa..e53dfa134297e 100644 --- a/src/java.base/share/classes/javax/crypto/Cipher.java +++ b/src/java.base/share/classes/javax/crypto/Cipher.java @@ -164,6 +164,8 @@ * Consult the release documentation for your implementation to see if any * other transformations are supported. * + * @spec https://www.rfc-editor.org/info/rfc5116 RFC 5116: An Interface and Algorithms for Authenticated Encryption + * @spec https://www.rfc-editor.org/info/rfc7539 RFC 7539: ChaCha20 and Poly1305 for IETF Protocols * @author Jan Luehe * @see KeyGenerator * @see SecretKey diff --git a/src/java.base/share/classes/javax/crypto/EncryptedPrivateKeyInfo.java b/src/java.base/share/classes/javax/crypto/EncryptedPrivateKeyInfo.java index e08f994545022..210cee12447fc 100644 --- a/src/java.base/share/classes/javax/crypto/EncryptedPrivateKeyInfo.java +++ b/src/java.base/share/classes/javax/crypto/EncryptedPrivateKeyInfo.java @@ -137,6 +137,7 @@ public EncryptedPrivateKeyInfo(byte[] encoded) throws IOException { * is empty, i.e. 0-length. * @exception NoSuchAlgorithmException if the specified algName is * not supported. + * @spec security/standard-names.html Java Security Standard Algorithm Names */ public EncryptedPrivateKeyInfo(String algName, byte[] encryptedData) throws NoSuchAlgorithmException { @@ -226,6 +227,7 @@ public EncryptedPrivateKeyInfo(AlgorithmParameters algParams, * for information about standard Cipher algorithm names. * * @return the encryption algorithm name. + * @spec security/standard-names.html Java Security Standard Algorithm Names */ public String getAlgName() { return algid == null ? params.getAlgorithm() : algid.getName(); diff --git a/src/java.base/share/classes/javax/crypto/package-info.java b/src/java.base/share/classes/javax/crypto/package-info.java index 159823f0fa701..e4c9d4fca0724 100644 --- a/src/java.base/share/classes/javax/crypto/package-info.java +++ b/src/java.base/share/classes/javax/crypto/package-info.java @@ -59,6 +59,7 @@ * How to Implement a Provider in the Java Cryptography Architecture}
    • * * + * @spec security/standard-names.html Java Security Standard Algorithm Names * @since 1.4 */ package javax.crypto; diff --git a/src/java.base/share/classes/javax/crypto/spec/ChaCha20ParameterSpec.java b/src/java.base/share/classes/javax/crypto/spec/ChaCha20ParameterSpec.java index 75c0526946042..034ec189b6bb4 100644 --- a/src/java.base/share/classes/javax/crypto/spec/ChaCha20ParameterSpec.java +++ b/src/java.base/share/classes/javax/crypto/spec/ChaCha20ParameterSpec.java @@ -39,6 +39,7 @@ *

    This class can be used to initialize a {@code Cipher} object that * implements the ChaCha20 algorithm. * + * @spec https://www.rfc-editor.org/info/rfc7539 RFC 7539: ChaCha20 and Poly1305 for IETF Protocols * @since 11 */ public final class ChaCha20ParameterSpec implements AlgorithmParameterSpec { diff --git a/src/java.base/share/classes/javax/crypto/spec/GCMParameterSpec.java b/src/java.base/share/classes/javax/crypto/spec/GCMParameterSpec.java index 879d729c2ca0f..3d42d51d87dbb 100644 --- a/src/java.base/share/classes/javax/crypto/spec/GCMParameterSpec.java +++ b/src/java.base/share/classes/javax/crypto/spec/GCMParameterSpec.java @@ -56,6 +56,7 @@ * applications. Other values can be specified for this class, but not * all CSP implementations will support them. * + * @spec https://www.rfc-editor.org/info/rfc5116 RFC 5116: An Interface and Algorithms for Authenticated Encryption * @see javax.crypto.Cipher * * @since 1.7 diff --git a/src/java.base/share/classes/javax/crypto/spec/OAEPParameterSpec.java b/src/java.base/share/classes/javax/crypto/spec/OAEPParameterSpec.java index efc8f3708770f..46084ed05b4d9 100644 --- a/src/java.base/share/classes/javax/crypto/spec/OAEPParameterSpec.java +++ b/src/java.base/share/classes/javax/crypto/spec/OAEPParameterSpec.java @@ -72,6 +72,7 @@ * EncodingParameters ::= OCTET STRING(SIZE(0..MAX)) * * + * @spec https://www.rfc-editor.org/info/rfc8017 RFC 8017: PKCS #1: RSA Cryptography Specifications Version 2.2 * @see java.security.spec.MGF1ParameterSpec * @see PSource * diff --git a/src/java.base/share/classes/javax/crypto/spec/PBEKeySpec.java b/src/java.base/share/classes/javax/crypto/spec/PBEKeySpec.java index b21b610e78040..8f14d1ca030c7 100644 --- a/src/java.base/share/classes/javax/crypto/spec/PBEKeySpec.java +++ b/src/java.base/share/classes/javax/crypto/spec/PBEKeySpec.java @@ -54,6 +54,7 @@ * this class requests the password as a char array, so it can be overwritten * when done. * + * @spec https://www.rfc-editor.org/info/rfc2898 RFC 2898: PKCS #5: Password-Based Cryptography Specification Version 2.0 * @author Jan Luehe * @author Valerie Peng * diff --git a/src/java.base/share/classes/javax/crypto/spec/PBEParameterSpec.java b/src/java.base/share/classes/javax/crypto/spec/PBEParameterSpec.java index 84d175dfd9f7d..52b334c8fb342 100644 --- a/src/java.base/share/classes/javax/crypto/spec/PBEParameterSpec.java +++ b/src/java.base/share/classes/javax/crypto/spec/PBEParameterSpec.java @@ -33,6 +33,7 @@ * PKCS #5 * standard. * + * @spec https://www.rfc-editor.org/info/rfc2898 RFC 2898: PKCS #5: Password-Based Cryptography Specification Version 2.0 * @author Jan Luehe * * @since 1.4 diff --git a/src/java.base/share/classes/javax/crypto/spec/PSource.java b/src/java.base/share/classes/javax/crypto/spec/PSource.java index 1cd57c6f03b2c..0831f9198d9f7 100644 --- a/src/java.base/share/classes/javax/crypto/spec/PSource.java +++ b/src/java.base/share/classes/javax/crypto/spec/PSource.java @@ -42,6 +42,7 @@ * } * EncodingParameters ::= OCTET STRING(SIZE(0..MAX)) * + * @spec https://www.rfc-editor.org/info/rfc8017 RFC 8017: PKCS #1: RSA Cryptography Specifications Version 2.2 * @author Valerie Peng * * @since 1.5 diff --git a/src/java.base/share/classes/javax/crypto/spec/RC2ParameterSpec.java b/src/java.base/share/classes/javax/crypto/spec/RC2ParameterSpec.java index 16812dcc3892f..61cd0785ad981 100644 --- a/src/java.base/share/classes/javax/crypto/spec/RC2ParameterSpec.java +++ b/src/java.base/share/classes/javax/crypto/spec/RC2ParameterSpec.java @@ -38,6 +38,7 @@ *

    This class can be used to initialize a {@code Cipher} object that * implements the RC2 algorithm. * + * @spec https://www.rfc-editor.org/info/rfc2268 RFC 2268: A Description of the RC2(r) Encryption Algorithm * @author Jan Luehe * * @since 1.4 diff --git a/src/java.base/share/classes/javax/crypto/spec/RC5ParameterSpec.java b/src/java.base/share/classes/javax/crypto/spec/RC5ParameterSpec.java index 4bee63d993235..d4b8bdddf3faa 100644 --- a/src/java.base/share/classes/javax/crypto/spec/RC5ParameterSpec.java +++ b/src/java.base/share/classes/javax/crypto/spec/RC5ParameterSpec.java @@ -40,6 +40,7 @@ * RSA Security LLC, * or any parties authorized by RSA Security. * + * @spec https://www.rfc-editor.org/info/rfc2040 RFC 2040: The RC5, RC5-CBC, RC5-CBC-Pad, and RC5-CTS Algorithms * @author Jan Luehe * * @since 1.4 diff --git a/src/java.base/share/classes/javax/crypto/spec/SecretKeySpec.java b/src/java.base/share/classes/javax/crypto/spec/SecretKeySpec.java index 5517d88157d94..3f907263a2da3 100644 --- a/src/java.base/share/classes/javax/crypto/spec/SecretKeySpec.java +++ b/src/java.base/share/classes/javax/crypto/spec/SecretKeySpec.java @@ -95,6 +95,7 @@ public class SecretKeySpec implements KeySpec, SecretKey { * for information about standard algorithm names. * @exception IllegalArgumentException if algorithm * is null or key is null or empty. + * @spec security/standard-names.html Java Security Standard Algorithm Names */ public SecretKeySpec(byte[] key, String algorithm) { if (key == null || algorithm == null) { @@ -143,6 +144,7 @@ public SecretKeySpec(byte[] key, String algorithm) { * @exception ArrayIndexOutOfBoundsException is thrown if * offset or len index bytes outside the * key. + * @spec security/standard-names.html Java Security Standard Algorithm Names */ public SecretKeySpec(byte[] key, int offset, int len, String algorithm) { if (key == null || algorithm == null) { diff --git a/src/java.base/share/classes/javax/net/ssl/ExtendedSSLSession.java b/src/java.base/share/classes/javax/net/ssl/ExtendedSSLSession.java index c1ddf221ab503..6b67d81a881c7 100644 --- a/src/java.base/share/classes/javax/net/ssl/ExtendedSSLSession.java +++ b/src/java.base/share/classes/javax/net/ssl/ExtendedSSLSession.java @@ -63,6 +63,7 @@ public ExtendedSSLSession() {} * order of preference. The return value is an empty array if * no signature algorithm is supported. * + * @spec security/standard-names.html Java Security Standard Algorithm Names * @see SSLParameters#getAlgorithmConstraints */ public abstract String[] getLocalSupportedSignatureAlgorithms(); @@ -86,6 +87,7 @@ public ExtendedSSLSession() {} * order of preference. The return value is an empty array if * the peer has not sent the supported signature algorithms. * + * @spec security/standard-names.html Java Security Standard Algorithm Names * @see X509KeyManager * @see X509ExtendedKeyManager */ diff --git a/src/java.base/share/classes/javax/net/ssl/SNIHostName.java b/src/java.base/share/classes/javax/net/ssl/SNIHostName.java index 9648ebced8fd2..e28291ca52eec 100644 --- a/src/java.base/share/classes/javax/net/ssl/SNIHostName.java +++ b/src/java.base/share/classes/javax/net/ssl/SNIHostName.java @@ -53,6 +53,8 @@ *

    * Note that {@code SNIHostName} objects are immutable. * + * @spec https://www.rfc-editor.org/info/rfc5890 RFC 5890: Internationalized Domain Names for Applications (IDNA): Definitions and Document Framework + * @spec https://www.rfc-editor.org/info/rfc6066 RFC 6066: Transport Layer Security (TLS) Extensions: Extension Definitions * @see SNIServerName * @see StandardConstants#SNI_HOST_NAME * @@ -92,6 +94,10 @@ public final class SNIHostName extends SNIServerName { * * @throws NullPointerException if {@code hostname} is {@code null} * @throws IllegalArgumentException if {@code hostname} is illegal + * @spec https://www.rfc-editor.org/info/rfc1122 RFC 1122: Requirements for Internet Hosts - Communication Layers + * @spec https://www.rfc-editor.org/info/rfc1123 RFC 1123: Requirements for Internet Hosts - Application and Support + * @spec https://www.rfc-editor.org/info/rfc3490 RFC 3490: Internationalizing Domain Names in Applications (IDNA) + * @spec https://www.rfc-editor.org/info/rfc6066 RFC 6066: Transport Layer Security (TLS) Extensions: Extension Definitions */ public SNIHostName(String hostname) { // IllegalArgumentException will be thrown if {@code hostname} is @@ -159,6 +165,11 @@ public SNIHostName(String hostname) { * * @throws NullPointerException if {@code encoded} is {@code null} * @throws IllegalArgumentException if {@code encoded} is illegal + * @spec https://www.rfc-editor.org/info/rfc1122 RFC 1122: Requirements for Internet Hosts - Communication Layers + * @spec https://www.rfc-editor.org/info/rfc1123 RFC 1123: Requirements for Internet Hosts - Application and Support + * @spec https://www.rfc-editor.org/info/rfc3490 RFC 3490: Internationalizing Domain Names in Applications (IDNA) + * @spec https://www.rfc-editor.org/info/rfc4366 RFC 4366: Transport Layer Security (TLS) Extensions + * @spec https://www.rfc-editor.org/info/rfc6066 RFC 6066: Transport Layer Security (TLS) Extensions: Extension Definitions */ public SNIHostName(byte[] encoded) { // NullPointerException will be thrown if {@code encoded} is null @@ -198,6 +209,8 @@ public SNIHostName(byte[] encoded) { * * @return the {@link StandardCharsets#US_ASCII}-compliant hostname * of this {@code SNIHostName} object + * @spec https://www.rfc-editor.org/info/rfc5890 RFC 5890: Internationalized Domain Names for Applications (IDNA): Definitions and Document Framework + * @spec https://www.rfc-editor.org/info/rfc6066 RFC 6066: Transport Layer Security (TLS) Extensions: Extension Definitions */ public String getAsciiName() { return hostname; @@ -215,6 +228,7 @@ public String getAsciiName() { * the other server name object to compare with. * @return true if, and only if, the {@code other} is considered * equal to this instance + * @spec https://www.rfc-editor.org/info/rfc6066 RFC 6066: Transport Layer Security (TLS) Extensions: Extension Definitions */ @Override public boolean equals(Object other) { diff --git a/src/java.base/share/classes/javax/net/ssl/SNIServerName.java b/src/java.base/share/classes/javax/net/ssl/SNIServerName.java index 142bb33de8ed2..9606855bdab8e 100644 --- a/src/java.base/share/classes/javax/net/ssl/SNIServerName.java +++ b/src/java.base/share/classes/javax/net/ssl/SNIServerName.java @@ -41,6 +41,7 @@ * {@code SNIServerName} objects are immutable. Subclasses should not provide * methods that can change the state of an instance once it has been created. * + * @spec https://www.rfc-editor.org/info/rfc6066 RFC 6066: Transport Layer Security (TLS) Extensions: Extension Definitions * @see SSLParameters#getServerNames() * @see SSLParameters#setServerNames(List) * diff --git a/src/java.base/share/classes/javax/net/ssl/SSLEngine.java b/src/java.base/share/classes/javax/net/ssl/SSLEngine.java index 9a74c69f9f5ca..fb9ff5d945b72 100644 --- a/src/java.base/share/classes/javax/net/ssl/SSLEngine.java +++ b/src/java.base/share/classes/javax/net/ssl/SSLEngine.java @@ -413,6 +413,7 @@ * because there is no way to guarantee the eventual packet ordering. * * + * @spec https://www.rfc-editor.org/info/rfc2246 RFC 2246: The TLS Protocol Version 1.0 * @see SSLContext * @see SSLSocket * @see SSLServerSocket @@ -859,6 +860,7 @@ public abstract SSLEngineResult unwrap(ByteBuffer src, * if this engine has not received the proper SSL/TLS/DTLS close * notification message from the peer. * + * @spec https://www.rfc-editor.org/info/rfc2246 RFC 2246: The TLS Protocol Version 1.0 * @see #isInboundDone() * @see #isOutboundDone() */ @@ -1351,6 +1353,7 @@ public void setSSLParameters(SSLParameters params) { * Application-Layer Protocol Negotiation (ALPN), can negotiate * application-level values between peers. * + * @spec https://www.rfc-editor.org/info/rfc7301 RFC 7301: Transport Layer Security (TLS) Application-Layer Protocol Negotiation Extension * @implSpec * The implementation in this class throws * {@code UnsupportedOperationException} and performs no other action. diff --git a/src/java.base/share/classes/javax/net/ssl/SSLParameters.java b/src/java.base/share/classes/javax/net/ssl/SSLParameters.java index b4fbdf9a43792..d90f91c88b8c9 100644 --- a/src/java.base/share/classes/javax/net/ssl/SSLParameters.java +++ b/src/java.base/share/classes/javax/net/ssl/SSLParameters.java @@ -297,6 +297,7 @@ public String getEndpointIdentificationAlgorithm() { * Java Security Standard Algorithm Names document * for information about standard algorithm names. * + * @spec security/standard-names.html Java Security Standard Algorithm Names * @see X509ExtendedTrustManager * * @since 1.7 @@ -661,6 +662,7 @@ public String[] getApplicationProtocols() { * sslSocket.setSSLParameters(p); * * + * @spec https://www.rfc-editor.org/info/rfc7301 RFC 7301: Transport Layer Security (TLS) Application-Layer Protocol Negotiation Extension * @implSpec * This method will make a copy of the {@code protocols} array. * diff --git a/src/java.base/share/classes/javax/net/ssl/SSLSocket.java b/src/java.base/share/classes/javax/net/ssl/SSLSocket.java index d0c3c9ac2ddae..7b70809b5827b 100644 --- a/src/java.base/share/classes/javax/net/ssl/SSLSocket.java +++ b/src/java.base/share/classes/javax/net/ssl/SSLSocket.java @@ -759,6 +759,7 @@ public void setSSLParameters(SSLParameters params) { * Application-Layer Protocol Negotiation (ALPN), can negotiate * application-level values between peers. * + * @spec https://www.rfc-editor.org/info/rfc7301 RFC 7301: Transport Layer Security (TLS) Application-Layer Protocol Negotiation Extension * @implSpec * The implementation in this class throws * {@code UnsupportedOperationException} and performs no other action. diff --git a/src/java.base/share/classes/javax/net/ssl/SSLSocketFactory.java b/src/java.base/share/classes/javax/net/ssl/SSLSocketFactory.java index bd7c3d0157aac..9741397222692 100644 --- a/src/java.base/share/classes/javax/net/ssl/SSLSocketFactory.java +++ b/src/java.base/share/classes/javax/net/ssl/SSLSocketFactory.java @@ -198,6 +198,7 @@ public abstract Socket createSocket(Socket s, String host, * does not implement the operation * @throws NullPointerException if {@code s} is {@code null} * + * @spec https://www.rfc-editor.org/info/rfc6066 RFC 6066: Transport Layer Security (TLS) Extensions: Extension Definitions * @since 1.8 */ public Socket createSocket(Socket s, InputStream consumed, diff --git a/src/java.base/share/classes/javax/net/ssl/StandardConstants.java b/src/java.base/share/classes/javax/net/ssl/StandardConstants.java index 8e1df977b977f..a106d995f4b5b 100644 --- a/src/java.base/share/classes/javax/net/ssl/StandardConstants.java +++ b/src/java.base/share/classes/javax/net/ssl/StandardConstants.java @@ -49,6 +49,7 @@ private StandardConstants() { *

    * The value of this constant is {@value}. * + * @spec https://www.rfc-editor.org/info/rfc6066 RFC 6066: Transport Layer Security (TLS) Extensions: Extension Definitions * @see SNIServerName * @see SNIHostName */ diff --git a/src/java.base/share/classes/javax/net/ssl/package-info.java b/src/java.base/share/classes/javax/net/ssl/package-info.java index f41b3b7f19a8b..39ff1a73b9f0c 100644 --- a/src/java.base/share/classes/javax/net/ssl/package-info.java +++ b/src/java.base/share/classes/javax/net/ssl/package-info.java @@ -36,6 +36,7 @@ * * * + * @spec security/standard-names.html Java Security Standard Algorithm Names * @since 1.4 */ package javax.net.ssl; diff --git a/src/java.base/share/classes/javax/security/auth/login/package-info.java b/src/java.base/share/classes/javax/security/auth/login/package-info.java index 70d25f1acaa8b..939868bcf2521 100644 --- a/src/java.base/share/classes/javax/security/auth/login/package-info.java +++ b/src/java.base/share/classes/javax/security/auth/login/package-info.java @@ -33,6 +33,7 @@ * * * + * @spec security/standard-names.html Java Security Standard Algorithm Names * @since 1.4 */ package javax.security.auth.login; diff --git a/src/java.base/share/classes/javax/security/auth/x500/X500Principal.java b/src/java.base/share/classes/javax/security/auth/x500/X500Principal.java index e2c8795a2e21a..cc4ab6527328d 100644 --- a/src/java.base/share/classes/javax/security/auth/x500/X500Principal.java +++ b/src/java.base/share/classes/javax/security/auth/x500/X500Principal.java @@ -58,6 +58,9 @@ * {@code X509Certificate} return X500Principals representing the * issuer and subject fields of the certificate. * + * @spec https://www.rfc-editor.org/info/rfc1779 RFC 1779: A String Representation of Distinguished Names + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names + * @spec https://www.rfc-editor.org/info/rfc5280 RFC 5280: Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile * @see java.security.cert.X509Certificate * @since 1.4 */ @@ -124,6 +127,7 @@ public final class X500Principal implements Principal, java.io.Serializable { * is {@code null} * @exception IllegalArgumentException if the {@code name} * is improperly specified + * @spec https://www.rfc-editor.org/info/rfc4512 RFC 4512: Lightweight Directory Access Protocol (LDAP): Directory Information Models */ public X500Principal(String name) { this(name, Collections.emptyMap()); @@ -164,6 +168,7 @@ public X500Principal(String name) { * @exception IllegalArgumentException if the {@code name} is * improperly specified or a keyword in the {@code name} maps to an * OID that is not in the correct form + * @spec https://www.rfc-editor.org/info/rfc4512 RFC 4512: Lightweight Directory Access Protocol (LDAP): Directory Information Models * @since 1.6 */ public X500Principal(String name, Map keywordMap) { diff --git a/src/java.base/share/classes/javax/security/auth/x500/package-info.java b/src/java.base/share/classes/javax/security/auth/x500/package-info.java index 45859a79bedf0..4033630768043 100644 --- a/src/java.base/share/classes/javax/security/auth/x500/package-info.java +++ b/src/java.base/share/classes/javax/security/auth/x500/package-info.java @@ -44,6 +44,10 @@ * Directory Information Models * * + * @spec https://www.rfc-editor.org/info/rfc1779 RFC 1779: A String Representation of Distinguished Names + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names + * @spec https://www.rfc-editor.org/info/rfc4512 RFC 4512: Lightweight Directory Access Protocol (LDAP): Directory Information Models + * @spec https://www.rfc-editor.org/info/rfc5280 RFC 5280: Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile * @since 1.4 */ package javax.security.auth.x500; diff --git a/src/java.compiler/share/classes/javax/annotation/processing/Filer.java b/src/java.compiler/share/classes/javax/annotation/processing/Filer.java index a66dc011fa7c3..8139d8a495452 100644 --- a/src/java.compiler/share/classes/javax/annotation/processing/Filer.java +++ b/src/java.compiler/share/classes/javax/annotation/processing/Filer.java @@ -123,6 +123,7 @@ * annotation if the environment is configured so that that class or * interface is accessible. * + * @spec https://www.rfc-editor.org/info/rfc3986 RFC 3986: Uniform Resource Identifier (URI): Generic Syntax * @apiNote Some of the effect of overwriting a file can be * achieved by using a decorator-style pattern. Instead of * modifying a class directly, the class is designed so that either diff --git a/src/java.compiler/share/classes/javax/tools/JavaFileManager.java b/src/java.compiler/share/classes/javax/tools/JavaFileManager.java index 524109bdf4dbf..202a7839654b5 100644 --- a/src/java.compiler/share/classes/javax/tools/JavaFileManager.java +++ b/src/java.compiler/share/classes/javax/tools/JavaFileManager.java @@ -103,6 +103,7 @@ *

    Unless explicitly allowed, all methods in this interface might * throw a NullPointerException if given a {@code null} argument. * + * @spec https://www.rfc-editor.org/info/rfc3986 RFC 3986: Uniform Resource Identifier (URI): Generic Syntax * @see JavaFileObject * @see FileObject * @since 1.6 diff --git a/src/java.datatransfer/share/classes/java/awt/datatransfer/DataFlavor.java b/src/java.datatransfer/share/classes/java/awt/datatransfer/DataFlavor.java index 757c4f99f4508..18334c9f8a603 100644 --- a/src/java.datatransfer/share/classes/java/awt/datatransfer/DataFlavor.java +++ b/src/java.datatransfer/share/classes/java/awt/datatransfer/DataFlavor.java @@ -105,6 +105,8 @@ * to Use Drag and Drop and Data Transfer, section in * The Java Tutorial. * + * @spec https://www.rfc-editor.org/info/rfc2045 RFC 2045: Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies + * @spec https://www.rfc-editor.org/info/rfc2046 RFC 2046: Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types * @author Blake Sullivan * @author Laurence P. G. Cable * @author Jeff Dunn diff --git a/src/java.desktop/share/classes/java/awt/Desktop.java b/src/java.desktop/share/classes/java/awt/Desktop.java index a2eb50e0093f4..e4022d7773137 100644 --- a/src/java.desktop/share/classes/java/awt/Desktop.java +++ b/src/java.desktop/share/classes/java/awt/Desktop.java @@ -587,6 +587,7 @@ public void mail() throws IOException { * {@code AWTPermission("showWindowWithoutWarningBanner")} * permission, or the calling thread is not allowed to create a * subprocess + * @spec https://www.rfc-editor.org/info/rfc2368 RFC 2368: The mailto URL scheme * @see java.net.URI * @see java.awt.AWTPermission */ diff --git a/src/java.desktop/share/classes/java/awt/package-info.java b/src/java.desktop/share/classes/java/awt/package-info.java index 682a371dd8364..04cae952ea232 100644 --- a/src/java.desktop/share/classes/java/awt/package-info.java +++ b/src/java.desktop/share/classes/java/awt/package-info.java @@ -58,6 +58,7 @@ * The Java AWT Native Interface (JAWT) * * + * @spec AWT_Native_Interface.html The Java AWT Native Interface Specification and Guide * @since 1.0 */ package java.awt; diff --git a/src/java.desktop/share/classes/javax/imageio/plugins/tiff/BaselineTIFFTagSet.java b/src/java.desktop/share/classes/javax/imageio/plugins/tiff/BaselineTIFFTagSet.java index 340fe2aee77f8..9bbd2e80e24cb 100644 --- a/src/java.desktop/share/classes/javax/imageio/plugins/tiff/BaselineTIFFTagSet.java +++ b/src/java.desktop/share/classes/javax/imageio/plugins/tiff/BaselineTIFFTagSet.java @@ -221,6 +221,7 @@ public final class BaselineTIFFTagSet extends TIFFTagSet { /** * A value to be used with the "Compression" tag. * + * @spec https://www.rfc-editor.org/info/rfc1951 RFC 1951: DEFLATE Compressed Data Format Specification version 1.3 * @see #TAG_COMPRESSION * @see DEFLATE specification */ diff --git a/src/java.desktop/share/classes/javax/imageio/plugins/tiff/FaxTIFFTagSet.java b/src/java.desktop/share/classes/javax/imageio/plugins/tiff/FaxTIFFTagSet.java index 881df65993f7e..550f471d45e8e 100644 --- a/src/java.desktop/share/classes/javax/imageio/plugins/tiff/FaxTIFFTagSet.java +++ b/src/java.desktop/share/classes/javax/imageio/plugins/tiff/FaxTIFFTagSet.java @@ -31,6 +31,7 @@ * A class representing the extra tags found in a * TIFF-F (RFC 2036) file. * + * @spec https://www.rfc-editor.org/info/rfc2306 RFC 2306: Tag Image File Format (TIFF) - F Profile for Facsimile * @since 9 */ public final class FaxTIFFTagSet extends TIFFTagSet { diff --git a/src/java.desktop/share/classes/javax/print/DocFlavor.java b/src/java.desktop/share/classes/javax/print/DocFlavor.java index 0e04dfb471c86..4fe6f8e86db90 100644 --- a/src/java.desktop/share/classes/javax/print/DocFlavor.java +++ b/src/java.desktop/share/classes/javax/print/DocFlavor.java @@ -383,6 +383,8 @@ * Print Service instance supports without having to load the representation * classes, which may be problematic for limited-resource clients. * + * @spec https://www.rfc-editor.org/info/rfc2045 RFC 2045: Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies + * @spec https://www.rfc-editor.org/info/rfc2046 RFC 2046: Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types * @author Alan Kaminsky */ public class DocFlavor implements Serializable, Cloneable { @@ -403,6 +405,7 @@ public class DocFlavor implements Serializable, Cloneable { * valid only for the VM which returns it, for use in a {@code DocFlavor}. * This is the charset for all the "HOST" pre-defined {@code DocFlavors} in * the executing VM. + * @spec https://www.rfc-editor.org/info/rfc2278 RFC 2278: IANA Charset Registration Procedures */ @SuppressWarnings("removal") public static final String hostEncoding = diff --git a/src/java.desktop/share/classes/javax/print/attribute/standard/Compression.java b/src/java.desktop/share/classes/javax/print/attribute/standard/Compression.java index 16af07a723976..15acd67e375c3 100644 --- a/src/java.desktop/share/classes/javax/print/attribute/standard/Compression.java +++ b/src/java.desktop/share/classes/javax/print/attribute/standard/Compression.java @@ -67,6 +67,7 @@ public class Compression extends EnumSyntax implements DocAttribute { /** * GNU zip compression technology described in * RFC 1952. + * @spec https://www.rfc-editor.org/info/rfc1952 RFC 1952: GZIP file format specification version 4.3 */ public static final Compression GZIP = new Compression(2); diff --git a/src/java.desktop/share/classes/javax/print/attribute/standard/Fidelity.java b/src/java.desktop/share/classes/javax/print/attribute/standard/Fidelity.java index 9d54a1794c9d1..f909dd61faf07 100644 --- a/src/java.desktop/share/classes/javax/print/attribute/standard/Fidelity.java +++ b/src/java.desktop/share/classes/javax/print/attribute/standard/Fidelity.java @@ -47,6 +47,7 @@ * method returns the IPP string representation of the attribute value. See * RFC 2911 Section 15.1 for a * fuller description of the IPP fidelity attribute. + * @spec https://www.rfc-editor.org/info/rfc2911 RFC 2911: Internet Printing Protocol/1.1: Model and Semantics */ public final class Fidelity extends EnumSyntax implements PrintJobAttribute, PrintRequestAttribute { diff --git a/src/java.desktop/share/classes/javax/print/attribute/standard/MediaSizeName.java b/src/java.desktop/share/classes/javax/print/attribute/standard/MediaSizeName.java index 63846f4415682..d2cb12e5bb72a 100644 --- a/src/java.desktop/share/classes/javax/print/attribute/standard/MediaSizeName.java +++ b/src/java.desktop/share/classes/javax/print/attribute/standard/MediaSizeName.java @@ -42,6 +42,7 @@ * values of the IPP "media" attribute which names media sizes. The names of the * media sizes correspond to those in the IPP 1.1 RFC * RFC 2911 + * @spec https://www.rfc-editor.org/info/rfc2911 RFC 2911: Internet Printing Protocol/1.1: Model and Semantics */ public class MediaSizeName extends Media { diff --git a/src/java.desktop/share/classes/javax/print/attribute/standard/package-info.java b/src/java.desktop/share/classes/javax/print/attribute/standard/package-info.java index 1cf8a257d1fa4..b73a152b060f5 100644 --- a/src/java.desktop/share/classes/javax/print/attribute/standard/package-info.java +++ b/src/java.desktop/share/classes/javax/print/attribute/standard/package-info.java @@ -590,6 +590,7 @@ * later time. {@code IllegalArgumentException} and {@code NullPointerException} * are examples of typical and acceptable run time exceptions for such cases. * + * @spec https://www.rfc-editor.org/info/rfc2911 RFC 2911: Internet Printing Protocol/1.1: Model and Semantics * @since 1.4 */ package javax.print.attribute.standard; diff --git a/src/java.desktop/share/classes/javax/print/package-info.java b/src/java.desktop/share/classes/javax/print/package-info.java index 7334ac056558f..80f57ed8ff09f 100644 --- a/src/java.desktop/share/classes/javax/print/package-info.java +++ b/src/java.desktop/share/classes/javax/print/package-info.java @@ -127,6 +127,7 @@ * later time. {@code IllegalArgumentException} and {@code NullPointerException} * are examples of typical and acceptable run time exceptions for such cases. * + * @spec https://www.rfc-editor.org/info/rfc2911 RFC 2911: Internet Printing Protocol/1.1: Model and Semantics * @since 1.4 */ package javax.print; diff --git a/src/java.desktop/share/classes/javax/swing/JEditorPane.java b/src/java.desktop/share/classes/javax/swing/JEditorPane.java index ee2f174206c0a..a51f26cfec822 100644 --- a/src/java.desktop/share/classes/javax/swing/JEditorPane.java +++ b/src/java.desktop/share/classes/javax/swing/JEditorPane.java @@ -1615,6 +1615,7 @@ private void writeObject(ObjectOutputStream s) throws IOException { * it set the client {@link #putClientProperty property} with this name * to Boolean.TRUE. * + * @spec https://www.w3.org/TR/CSS22 Cascading Style Sheets Level 2 Revision 2 (CSS 2.2) Specification * @since 1.5 */ public static final String W3C_LENGTH_UNITS = "JEditorPane.w3cLengthUnits"; diff --git a/src/java.desktop/share/classes/javax/swing/text/html/CSS.java b/src/java.desktop/share/classes/javax/swing/text/html/CSS.java index 37a0c9306172b..e3d143cfae5c0 100644 --- a/src/java.desktop/share/classes/javax/swing/text/html/CSS.java +++ b/src/java.desktop/share/classes/javax/swing/text/html/CSS.java @@ -126,6 +126,7 @@ * unless noted, so that * p { margin-top: 10% } will be treated as if no margin-top was specified. * + * @spec https://www.w3.org/TR/REC-CSS1 Cascading Style Sheets, level 1 * @author Timothy Prinzing * @author Scott Violet * @see StyleSheet diff --git a/src/java.desktop/share/classes/javax/swing/text/html/package-info.java b/src/java.desktop/share/classes/javax/swing/text/html/package-info.java index 68f709ff20c32..8f32e2c41cf79 100644 --- a/src/java.desktop/share/classes/javax/swing/text/html/package-info.java +++ b/src/java.desktop/share/classes/javax/swing/text/html/package-info.java @@ -43,6 +43,7 @@ * which HTMLEditorKit is based. * * + * @spec https://www.w3.org/TR/REC-html32.html HTML 3.2 Reference Specification * @since 1.2 * @serial exclude */ diff --git a/src/java.management/share/classes/javax/management/remote/JMXServiceURL.java b/src/java.management/share/classes/javax/management/remote/JMXServiceURL.java index 61dfeaffeaeeb..ff016a1a37507 100644 --- a/src/java.management/share/classes/javax/management/remote/JMXServiceURL.java +++ b/src/java.management/share/classes/javax/management/remote/JMXServiceURL.java @@ -115,6 +115,8 @@ * part of the address. Depending on the protocol, case can be * significant in the url-path.

    * + * @spec https://www.rfc-editor.org/info/rfc2609 RFC 2609: Service Templates and Service: Schemes + * @spec https://www.rfc-editor.org/info/rfc3111 RFC 3111: Service Location Protocol Modifications for IPv6 * @see RFC 2609, * "Service Templates and Service: Schemes" diff --git a/src/java.naming/share/classes/javax/naming/event/EventDirContext.java b/src/java.naming/share/classes/javax/naming/event/EventDirContext.java index aecc55ce93e3b..421dacbd909a0 100644 --- a/src/java.naming/share/classes/javax/naming/event/EventDirContext.java +++ b/src/java.naming/share/classes/javax/naming/event/EventDirContext.java @@ -56,6 +56,7 @@ * passed as a parameter to any method is owned by the caller. * The service provider will not modify the object or keep a reference to it. * + * @spec https://www.rfc-editor.org/info/rfc2254 RFC 2254: The String Representation of LDAP Search Filters * @author Rosanna Lee * @author Scott Seligman * @since 1.3 diff --git a/src/java.naming/share/classes/javax/naming/ldap/BasicControl.java b/src/java.naming/share/classes/javax/naming/ldap/BasicControl.java index 0060d281563ca..61e64083494e3 100644 --- a/src/java.naming/share/classes/javax/naming/ldap/BasicControl.java +++ b/src/java.naming/share/classes/javax/naming/ldap/BasicControl.java @@ -30,6 +30,7 @@ * interface. It represents an LDAPv3 Control as defined in * RFC 2251. * + * @spec https://www.rfc-editor.org/info/rfc2251 RFC 2251: Lightweight Directory Access Protocol (v3) * @since 1.5 * @author Vincent Ryan */ diff --git a/src/java.naming/share/classes/javax/naming/ldap/Control.java b/src/java.naming/share/classes/javax/naming/ldap/Control.java index 93d21019f6524..7eed40d4244e2 100644 --- a/src/java.naming/share/classes/javax/naming/ldap/Control.java +++ b/src/java.naming/share/classes/javax/naming/ldap/Control.java @@ -42,6 +42,7 @@ *

    * This interface is used to represent both request and response controls. * + * @spec https://www.rfc-editor.org/info/rfc2251 RFC 2251: Lightweight Directory Access Protocol (v3) * @author Rosanna Lee * @author Scott Seligman * @author Vincent Ryan diff --git a/src/java.naming/share/classes/javax/naming/ldap/ControlFactory.java b/src/java.naming/share/classes/javax/naming/ldap/ControlFactory.java index 7bbdf311afc73..76d1aced3ff68 100644 --- a/src/java.naming/share/classes/javax/naming/ldap/ControlFactory.java +++ b/src/java.naming/share/classes/javax/naming/ldap/ControlFactory.java @@ -42,6 +42,7 @@ * When a service provider receives a response control, it uses control * factories to return the specific/appropriate control class implementation. * + * @spec https://www.rfc-editor.org/info/rfc2251 RFC 2251: Lightweight Directory Access Protocol (v3) * @author Rosanna Lee * @author Scott Seligman * @author Vincent Ryan diff --git a/src/java.naming/share/classes/javax/naming/ldap/ExtendedRequest.java b/src/java.naming/share/classes/javax/naming/ldap/ExtendedRequest.java index 3a81a2f699819..9a97e3e18dee7 100644 --- a/src/java.naming/share/classes/javax/naming/ldap/ExtendedRequest.java +++ b/src/java.naming/share/classes/javax/naming/ldap/ExtendedRequest.java @@ -76,6 +76,7 @@ * long time = resp.getTime(); * * + * @spec https://www.rfc-editor.org/info/rfc2251 RFC 2251: Lightweight Directory Access Protocol (v3) * @author Rosanna Lee * @author Scott Seligman * @author Vincent Ryan diff --git a/src/java.naming/share/classes/javax/naming/ldap/ExtendedResponse.java b/src/java.naming/share/classes/javax/naming/ldap/ExtendedResponse.java index 36c83fd122c48..66d3196df0795 100644 --- a/src/java.naming/share/classes/javax/naming/ldap/ExtendedResponse.java +++ b/src/java.naming/share/classes/javax/naming/ldap/ExtendedResponse.java @@ -62,6 +62,7 @@ * java.util.Date now = resp.getDate(); * * + * @spec https://www.rfc-editor.org/info/rfc2251 RFC 2251: Lightweight Directory Access Protocol (v3) * @author Rosanna Lee * @author Scott Seligman * @author Vincent Ryan diff --git a/src/java.naming/share/classes/javax/naming/ldap/LdapName.java b/src/java.naming/share/classes/javax/naming/ldap/LdapName.java index 773f3b534b45d..40984d8d3cbce 100644 --- a/src/java.naming/share/classes/javax/naming/ldap/LdapName.java +++ b/src/java.naming/share/classes/javax/naming/ldap/LdapName.java @@ -98,6 +98,7 @@ * to a constructor or method in this class will cause a * NullPointerException to be thrown. * + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names * @author Scott Seligman * @since 1.5 */ @@ -118,6 +119,7 @@ public class LdapName implements Name { * RFC 2253. * * @throws InvalidNameException if a syntax violation is detected. + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names * @see Rdn#escapeValue(Object value) */ public LdapName(String name) throws InvalidNameException { @@ -617,6 +619,7 @@ public Object clone() { * components an empty string is returned. * * @return The string representation of the LdapName. + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names */ public String toString() { if (unparsed != null) { diff --git a/src/java.naming/share/classes/javax/naming/ldap/ManageReferralControl.java b/src/java.naming/share/classes/javax/naming/ldap/ManageReferralControl.java index 8f4566de2976b..0d261d5d7a360 100644 --- a/src/java.naming/share/classes/javax/naming/ldap/ManageReferralControl.java +++ b/src/java.naming/share/classes/javax/naming/ldap/ManageReferralControl.java @@ -36,6 +36,7 @@ * * The control has no control value. * + * @spec https://www.rfc-editor.org/info/rfc3296 RFC 3296: Named Subordinate References in Lightweight Directory Access Protocol (LDAP) Directories * @since 1.5 * @author Vincent Ryan */ diff --git a/src/java.naming/share/classes/javax/naming/ldap/PagedResultsControl.java b/src/java.naming/share/classes/javax/naming/ldap/PagedResultsControl.java index ba3d42fb0a761..fd636fe9ca2b4 100644 --- a/src/java.naming/share/classes/javax/naming/ldap/PagedResultsControl.java +++ b/src/java.naming/share/classes/javax/naming/ldap/PagedResultsControl.java @@ -106,6 +106,7 @@ * * } * + * @spec https://www.rfc-editor.org/info/rfc2696 RFC 2696: LDAP Control Extension for Simple Paged Results Manipulation * @since 1.5 * @see PagedResultsResponseControl * @author Vincent Ryan diff --git a/src/java.naming/share/classes/javax/naming/ldap/PagedResultsResponseControl.java b/src/java.naming/share/classes/javax/naming/ldap/PagedResultsResponseControl.java index d9d20f2bdedb2..93650d4eb7526 100644 --- a/src/java.naming/share/classes/javax/naming/ldap/PagedResultsResponseControl.java +++ b/src/java.naming/share/classes/javax/naming/ldap/PagedResultsResponseControl.java @@ -54,6 +54,7 @@ * * * + * @spec https://www.rfc-editor.org/info/rfc2696 RFC 2696: LDAP Control Extension for Simple Paged Results Manipulation * @since 1.5 * @see PagedResultsControl * @author Vincent Ryan diff --git a/src/java.naming/share/classes/javax/naming/ldap/Rdn.java b/src/java.naming/share/classes/javax/naming/ldap/Rdn.java index 6d2caedc4baeb..6103c0f8912a6 100644 --- a/src/java.naming/share/classes/javax/naming/ldap/Rdn.java +++ b/src/java.naming/share/classes/javax/naming/ldap/Rdn.java @@ -102,6 +102,7 @@ * to a constructor or method in this class will cause NullPointerException * to be thrown. * + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names * @since 1.5 */ @@ -128,6 +129,7 @@ public class Rdn implements Serializable, Comparable { * type/value mappings. * @throws InvalidNameException If contents of {@code attrSet} cannot * be used to construct a valid RDN. + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names */ public Rdn(Attributes attrSet) throws InvalidNameException { if (attrSet.size() == 0) { @@ -162,6 +164,7 @@ public Rdn(Attributes attrSet) throws InvalidNameException { * @param rdnString The non-null and non-empty RFC2253 formatted string. * @throws InvalidNameException If a syntax error occurs during * parsing of the rdnString. + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names */ public Rdn(String rdnString) throws InvalidNameException { entries = new ArrayList<>(DEFAULT_SIZE); @@ -191,6 +194,7 @@ public Rdn(Rdn rdn) { * @param value The non-null and non-empty attribute value. * @throws InvalidNameException If type/value cannot be used to * construct a valid RDN. + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names * @see #toString() */ public Rdn(String type, Object value) throws InvalidNameException { @@ -287,6 +291,7 @@ public String getType() { * in the class description for {@link javax.naming.ldap.LdapName LdapName}. * * @return The string representation of the Rdn. + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names */ public String toString() { StringBuilder builder = new StringBuilder(); @@ -509,6 +514,7 @@ public int size() { * @param val The non-null object to be escaped. * @return Escaped string value. * @throws ClassCastException if val is not a String or byte array. + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names */ public static String escapeValue(Object val) { return (val instanceof byte[]) @@ -592,6 +598,7 @@ private static String escapeBinaryValue(byte[] val) { * @return Unescaped value. * @throws IllegalArgumentException When an Illegal value * is provided. + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names */ public static Object unescapeValue(String val) { diff --git a/src/java.naming/share/classes/javax/naming/ldap/SortControl.java b/src/java.naming/share/classes/javax/naming/ldap/SortControl.java index 90b869f05c993..a5f9f3d45e730 100644 --- a/src/java.naming/share/classes/javax/naming/ldap/SortControl.java +++ b/src/java.naming/share/classes/javax/naming/ldap/SortControl.java @@ -101,6 +101,7 @@ * * * + * @spec https://www.rfc-editor.org/info/rfc2891 RFC 2891: LDAP Control Extension for Server Side Sorting of Search Results * @since 1.5 * @see SortKey * @see SortResponseControl diff --git a/src/java.naming/share/classes/javax/naming/ldap/SortKey.java b/src/java.naming/share/classes/javax/naming/ldap/SortKey.java index 38401c4a54ba4..bce2c1ab17afc 100644 --- a/src/java.naming/share/classes/javax/naming/ldap/SortKey.java +++ b/src/java.naming/share/classes/javax/naming/ldap/SortKey.java @@ -31,6 +31,7 @@ * Control for server-side sorting of search results as defined in * RFC 2891. * + * @spec https://www.rfc-editor.org/info/rfc2891 RFC 2891: LDAP Control Extension for Server Side Sorting of Search Results * @since 1.5 * @see SortControl * @author Vincent Ryan diff --git a/src/java.naming/share/classes/javax/naming/ldap/SortResponseControl.java b/src/java.naming/share/classes/javax/naming/ldap/SortResponseControl.java index ebaecd51341c2..d80c37415910f 100644 --- a/src/java.naming/share/classes/javax/naming/ldap/SortResponseControl.java +++ b/src/java.naming/share/classes/javax/naming/ldap/SortResponseControl.java @@ -73,6 +73,7 @@ * * * + * @spec https://www.rfc-editor.org/info/rfc2891 RFC 2891: LDAP Control Extension for Server Side Sorting of Search Results * @since 1.5 * @see SortControl * @author Vincent Ryan diff --git a/src/java.naming/share/classes/javax/naming/ldap/StartTlsRequest.java b/src/java.naming/share/classes/javax/naming/ldap/StartTlsRequest.java index 1e519609484fb..ed9360912ffce 100644 --- a/src/java.naming/share/classes/javax/naming/ldap/StartTlsRequest.java +++ b/src/java.naming/share/classes/javax/naming/ldap/StartTlsRequest.java @@ -72,6 +72,7 @@ * ctx.close; * * + * @spec https://www.rfc-editor.org/info/rfc2830 RFC 2830: Lightweight Directory Access Protocol (v3): Extension for Transport Layer Security * @since 1.4 * @see StartTlsResponse * @author Vincent Ryan diff --git a/src/java.naming/share/classes/javax/naming/ldap/StartTlsResponse.java b/src/java.naming/share/classes/javax/naming/ldap/StartTlsResponse.java index 80cf71bcd8a4b..c53fe5495bd90 100644 --- a/src/java.naming/share/classes/javax/naming/ldap/StartTlsResponse.java +++ b/src/java.naming/share/classes/javax/naming/ldap/StartTlsResponse.java @@ -70,6 +70,7 @@ * ctx.close; * * + * @spec https://www.rfc-editor.org/info/rfc2830 RFC 2830: Lightweight Directory Access Protocol (v3): Extension for Transport Layer Security * @since 1.4 * @see StartTlsRequest * @author Vincent Ryan diff --git a/src/java.naming/share/classes/javax/naming/ldap/UnsolicitedNotification.java b/src/java.naming/share/classes/javax/naming/ldap/UnsolicitedNotification.java index e9e12226934c6..004064299bdf3 100644 --- a/src/java.naming/share/classes/javax/naming/ldap/UnsolicitedNotification.java +++ b/src/java.naming/share/classes/javax/naming/ldap/UnsolicitedNotification.java @@ -34,6 +34,7 @@ * client without any provocation from the client. * Its format is that of an extended response ({@code ExtendedResponse}). * + * @spec https://www.rfc-editor.org/info/rfc2251 RFC 2251: Lightweight Directory Access Protocol (v3) * @author Rosanna Lee * @author Scott Seligman * @author Vincent Ryan diff --git a/src/java.naming/share/classes/javax/naming/ldap/UnsolicitedNotificationListener.java b/src/java.naming/share/classes/javax/naming/ldap/UnsolicitedNotificationListener.java index 57348a83e31ae..5a0c081e784f9 100644 --- a/src/java.naming/share/classes/javax/naming/ldap/UnsolicitedNotificationListener.java +++ b/src/java.naming/share/classes/javax/naming/ldap/UnsolicitedNotificationListener.java @@ -46,6 +46,7 @@ * other listener interfaces). * * + * @spec https://www.rfc-editor.org/info/rfc2251 RFC 2251: Lightweight Directory Access Protocol (v3) * @author Rosanna Lee * @author Scott Seligman * @author Vincent Ryan diff --git a/src/java.naming/share/classes/javax/naming/ldap/spi/LdapDnsProvider.java b/src/java.naming/share/classes/javax/naming/ldap/spi/LdapDnsProvider.java index e127dc11f7f48..75efdc2eecf9e 100644 --- a/src/java.naming/share/classes/javax/naming/ldap/spi/LdapDnsProvider.java +++ b/src/java.naming/share/classes/javax/naming/ldap/spi/LdapDnsProvider.java @@ -103,6 +103,7 @@ private static Void checkPermission() { * occurred while performing the lookup. * @throws NullPointerException if either {@code url} or {@code env} are * {@code null}. + * @spec https://www.rfc-editor.org/info/rfc2255 RFC 2255: The LDAP URL Format */ public abstract Optional lookupEndpoints( String url, Map env) throws NamingException; diff --git a/src/java.net.http/share/classes/java/net/http/HttpClient.java b/src/java.net.http/share/classes/java/net/http/HttpClient.java index 2cb2a5d21de3b..52576d4c60e49 100644 --- a/src/java.net.http/share/classes/java/net/http/HttpClient.java +++ b/src/java.net.http/share/classes/java/net/http/HttpClient.java @@ -302,6 +302,7 @@ public interface Builder { * will use HTTP/2. If the upgrade fails, then the response will be * handled using HTTP/1.1 * + * @spec https://www.rfc-editor.org/info/rfc6454 RFC 6454: The Web Origin Concept * @implNote Constraints may also affect the selection of protocol version. * For example, if HTTP/2 is requested through a proxy, and if the implementation * does not support this mode, then HTTP/1.1 may be used @@ -543,6 +544,7 @@ public enum Version { * HttpClient.Builder#followRedirects(Redirect) Builder.followRedirects} * method. * + * @spec https://www.rfc-editor.org/info/rfc7231 RFC 7231: Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content * @implNote When automatic redirection occurs, the request method of the * redirected request may be modified depending on the specific {@code 30X} * status code, as specified in diff --git a/src/java.net.http/share/classes/java/net/http/HttpRequest.java b/src/java.net.http/share/classes/java/net/http/HttpRequest.java index 974ea54717ee3..84e126ec2efe3 100644 --- a/src/java.net.http/share/classes/java/net/http/HttpRequest.java +++ b/src/java.net.http/share/classes/java/net/http/HttpRequest.java @@ -153,6 +153,7 @@ public interface Builder { * Adds the given name value pair to the set of headers for this request. * The given value is added to the list of values for that name. * + * @spec https://www.rfc-editor.org/info/rfc7230 RFC 7230: Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing * @implNote An implementation may choose to restrict some header names * or values, as the HTTP Client may determine their value itself. * For example, "Content-Length", which will be determined by @@ -186,6 +187,7 @@ public interface Builder { * RFC 7230 section-3.2, or a header name or value is * {@linkplain #header(String, String) restricted} by the * implementation. + * @spec https://www.rfc-editor.org/info/rfc7230 RFC 7230: Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing */ public Builder headers(String... headers); @@ -218,6 +220,7 @@ public interface Builder { * RFC 7230 section-3.2, or the header name or value is * {@linkplain #header(String, String) restricted} by the * implementation. + * @spec https://www.rfc-editor.org/info/rfc7230 RFC 7230: Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing */ public Builder setHeader(String name, String value); @@ -273,6 +276,7 @@ default Builder HEAD() { * Sets the request method and request body of this builder to the * given values. * + * @spec https://www.rfc-editor.org/info/rfc7230 RFC 7230: Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing * @apiNote The {@link BodyPublishers#noBody() noBody} request * body publisher can be used where no request body is required or * appropriate. Whether a method is restricted, or not, is diff --git a/src/java.net.http/share/classes/java/net/http/package-info.java b/src/java.net.http/share/classes/java/net/http/package-info.java index c0df4e04588ee..319a4b808afdb 100644 --- a/src/java.net.http/share/classes/java/net/http/package-info.java +++ b/src/java.net.http/share/classes/java/net/http/package-info.java @@ -64,6 +64,9 @@ *

    Unless otherwise stated, {@code null} parameter values will cause methods * of all classes in this package to throw {@code NullPointerException}. * + * @spec https://www.rfc-editor.org/info/rfc2616 RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1 + * @spec https://www.rfc-editor.org/info/rfc6455 RFC 6455: The WebSocket Protocol + * @spec https://www.rfc-editor.org/info/rfc7540 RFC 7540: Hypertext Transfer Protocol Version 2 (HTTP/2) * @since 11 */ package java.net.http; diff --git a/src/java.prefs/share/classes/java/util/prefs/Preferences.java b/src/java.prefs/share/classes/java/util/prefs/Preferences.java index a094d7d9e797f..fbf3957fdad6a 100644 --- a/src/java.prefs/share/classes/java/util/prefs/Preferences.java +++ b/src/java.prefs/share/classes/java/util/prefs/Preferences.java @@ -857,6 +857,7 @@ protected Preferences() { * removed with the {@link #removeNode()} method. * @throws IllegalArgumentException if key contains * the null control character, code point U+0000. + * @spec https://www.rfc-editor.org/info/rfc2045 RFC 2045: Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies * @see #getByteArray(String,byte[]) * @see #get(String,String) */ @@ -898,6 +899,7 @@ protected Preferences() { * {@code null} value for {@code def} is permitted.) * @throws IllegalArgumentException if key contains the null control * character, code point U+0000. + * @spec https://www.rfc-editor.org/info/rfc2045 RFC 2045: Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies * @see #get(String,String) * @see #putByteArray(String,byte[]) */ diff --git a/src/java.rmi/share/classes/java/rmi/Remote.java b/src/java.rmi/share/classes/java/rmi/Remote.java index 2dedfe66f8622..9225fcc4cee3d 100644 --- a/src/java.rmi/share/classes/java/rmi/Remote.java +++ b/src/java.rmi/share/classes/java/rmi/Remote.java @@ -42,6 +42,7 @@ * href="{@docRoot}/../specs/rmi/index.html">RMI Specification which * describes the RMI API and system. * + * @spec rmi/index.html Java Remote Method Invocation Specification * @since 1.1 * @author Ann Wollrath */ diff --git a/src/java.rmi/share/classes/java/rmi/server/UnicastRemoteObject.java b/src/java.rmi/share/classes/java/rmi/server/UnicastRemoteObject.java index 8d6472a0e2709..b6487206ebb44 100644 --- a/src/java.rmi/share/classes/java/rmi/server/UnicastRemoteObject.java +++ b/src/java.rmi/share/classes/java/rmi/server/UnicastRemoteObject.java @@ -161,6 +161,7 @@ * thrown by {@code ObjectInputStream} is reported as the cause of an * {@link UnmarshalException}. * + * @spec rmi/index.html Java Remote Method Invocation Specification * @implNote * Depending upon which constructor or static method is used for exporting an * object, {@link RMISocketFactory} may be used for creating sockets. diff --git a/src/java.se/share/classes/module-info.java b/src/java.se/share/classes/module-info.java index 81b1bd3cb8aa9..ad6aa7dbe35e3 100644 --- a/src/java.se/share/classes/module-info.java +++ b/src/java.se/share/classes/module-info.java @@ -35,6 +35,8 @@ * * * + * @spec jdwp/jdwp-spec.html Java Debug Wire Protocol + * @spec jni/index.html Java Native Interface Specification * @moduleGraph * @since 9 */ diff --git a/src/java.security.jgss/share/classes/javax/security/auth/kerberos/EncryptionKey.java b/src/java.security.jgss/share/classes/javax/security/auth/kerberos/EncryptionKey.java index 08463c883ac3d..910fd923540a9 100644 --- a/src/java.security.jgss/share/classes/javax/security/auth/kerberos/EncryptionKey.java +++ b/src/java.security.jgss/share/classes/javax/security/auth/kerberos/EncryptionKey.java @@ -45,6 +45,7 @@ * The key material of an {@code EncryptionKey} is defined as the value * of the {@code keyValue} above. * + * @spec https://www.rfc-editor.org/info/rfc4120 RFC 4120: The Kerberos Network Authentication Service (V5) * @since 9 */ public final class EncryptionKey implements SecretKey { diff --git a/src/java.security.jgss/share/classes/javax/security/auth/kerberos/KerberosCredMessage.java b/src/java.security.jgss/share/classes/javax/security/auth/kerberos/KerberosCredMessage.java index 3045fd7818014..f8cbd31ea5b4b 100644 --- a/src/java.security.jgss/share/classes/javax/security/auth/kerberos/KerberosCredMessage.java +++ b/src/java.security.jgss/share/classes/javax/security/auth/kerberos/KerberosCredMessage.java @@ -45,6 +45,7 @@ * } * * + * @spec https://www.rfc-editor.org/info/rfc4120 RFC 4120: The Kerberos Network Authentication Service (V5) * @since 9 */ public final class KerberosCredMessage implements Destroyable { diff --git a/src/java.security.jgss/share/classes/javax/security/auth/kerberos/KerberosKey.java b/src/java.security.jgss/share/classes/javax/security/auth/kerberos/KerberosKey.java index 5c11c23d63a9e..2105076819286 100644 --- a/src/java.security.jgss/share/classes/javax/security/auth/kerberos/KerberosKey.java +++ b/src/java.security.jgss/share/classes/javax/security/auth/kerberos/KerberosKey.java @@ -75,6 +75,7 @@ * "ArcFourMac" for "rc4-hmac"), but the {@link #getAlgorithm} method * must always return the IANA algorithm name. * + * @spec https://www.rfc-editor.org/info/rfc4120 RFC 4120: The Kerberos Network Authentication Service (V5) * @implNote Old algorithm names used before JDK 9 are supported in the * {@link #KerberosKey(KerberosPrincipal, char[], String)} constructor in this * implementation for compatibility reasons, which are "DES" (and null) for diff --git a/src/java.security.jgss/share/classes/javax/security/auth/kerberos/KerberosPrincipal.java b/src/java.security.jgss/share/classes/javax/security/auth/kerberos/KerberosPrincipal.java index a42d6625ee345..c84aad8e49ef4 100644 --- a/src/java.security.jgss/share/classes/javax/security/auth/kerberos/KerberosPrincipal.java +++ b/src/java.security.jgss/share/classes/javax/security/auth/kerberos/KerberosPrincipal.java @@ -137,6 +137,7 @@ public final class KerberosPrincipal * @throws SecurityException if a security manager is installed and * {@code name} does not contain the realm to use, and a proper * {@link ServicePermission} as described above is not granted. + * @spec https://www.rfc-editor.org/info/rfc1964 RFC 1964: The Kerberos Version 5 GSS-API Mechanism */ public KerberosPrincipal(String name) { this(name, KRB_NT_PRINCIPAL); @@ -187,6 +188,8 @@ public KerberosPrincipal(String name) { * @throws SecurityException if a security manager is installed and * {@code name} does not contain the realm to use, and a proper * {@link ServicePermission} as described above is not granted. + * @spec https://www.rfc-editor.org/info/rfc1964 RFC 1964: The Kerberos Version 5 GSS-API Mechanism + * @spec https://www.rfc-editor.org/info/rfc4120 RFC 4120: The Kerberos Network Authentication Service (V5) */ public KerberosPrincipal(String name, int nameType) { @@ -319,6 +322,7 @@ private void readObject(ObjectInputStream ois) * Section 2.1 of RFC 1964. * * @return the principal name. + * @spec https://www.rfc-editor.org/info/rfc1964 RFC 1964: The Kerberos Version 5 GSS-API Mechanism */ public String getName() { return fullName; @@ -330,6 +334,7 @@ public String getName() { * RFC4120. * * @return the name type. + * @spec https://www.rfc-editor.org/info/rfc4120 RFC 4120: The Kerberos Network Authentication Service (V5) */ public int getNameType() { return nameType; diff --git a/src/java.security.jgss/share/classes/javax/security/auth/kerberos/KerberosTicket.java b/src/java.security.jgss/share/classes/javax/security/auth/kerberos/KerberosTicket.java index 8bf7fd167ba12..e2827d217f596 100644 --- a/src/java.security.jgss/share/classes/javax/security/auth/kerberos/KerberosTicket.java +++ b/src/java.security.jgss/share/classes/javax/security/auth/kerberos/KerberosTicket.java @@ -67,6 +67,7 @@ * other regular service tickets. A ticket granting ticket is just a * special case of a more generalized service ticket. * + * @spec https://www.rfc-editor.org/info/rfc4120 RFC 4120: The Kerberos Network Authentication Service (V5) * @implNote The JAAS login module in the JDK reference implementation destroys * all tickets after logout. * diff --git a/src/java.security.jgss/share/classes/javax/security/auth/kerberos/package-info.java b/src/java.security.jgss/share/classes/javax/security/auth/kerberos/package-info.java index 7b21522a58572..2c2f74c7c6116 100644 --- a/src/java.security.jgss/share/classes/javax/security/auth/kerberos/package-info.java +++ b/src/java.security.jgss/share/classes/javax/security/auth/kerberos/package-info.java @@ -54,6 +54,7 @@ * string or a boolean value. A boolean value can be one of "true", "false", * "yes", or "no", and values are case-insensitive. * + * @spec https://www.rfc-editor.org/info/rfc4120 RFC 4120: The Kerberos Network Authentication Service (V5) * @since 1.4 */ package javax.security.auth.kerberos; diff --git a/src/java.security.jgss/share/classes/org/ietf/jgss/GSSContext.java b/src/java.security.jgss/share/classes/org/ietf/jgss/GSSContext.java index d229635820ac3..bf0bc1113f070 100644 --- a/src/java.security.jgss/share/classes/org/ietf/jgss/GSSContext.java +++ b/src/java.security.jgss/share/classes/org/ietf/jgss/GSSContext.java @@ -207,6 +207,7 @@ * * * + * @spec https://www.rfc-editor.org/info/rfc8353 RFC 8353: Generic Security Service API Version 2: Java Bindings Update * @author Mayank Upadhyay * @since 1.4 */ diff --git a/src/java.security.jgss/share/classes/org/ietf/jgss/package-info.java b/src/java.security.jgss/share/classes/org/ietf/jgss/package-info.java index 12cd0debefda1..bb85fbcd1079c 100644 --- a/src/java.security.jgss/share/classes/org/ietf/jgss/package-info.java +++ b/src/java.security.jgss/share/classes/org/ietf/jgss/package-info.java @@ -97,6 +97,8 @@ * {@extLink security_guide_jgss_tutorial * Introduction to JAAS and Java GSS-API}. * + * @spec https://www.rfc-editor.org/info/rfc2743 RFC 2743: Generic Security Service Application Program Interface Version 2, Update 1 + * @spec https://www.rfc-editor.org/info/rfc2853 RFC 2853: Generic Security Service API Version 2 : Java Bindings * @since 1.4 * */ package org.ietf.jgss; diff --git a/src/java.security.sasl/share/classes/javax/security/sasl/package-info.java b/src/java.security.sasl/share/classes/javax/security/sasl/package-info.java index 553087f3a32a7..b259ed72f2857 100644 --- a/src/java.security.sasl/share/classes/javax/security/sasl/package-info.java +++ b/src/java.security.sasl/share/classes/javax/security/sasl/package-info.java @@ -98,6 +98,10 @@ * {@extLink security_guide_sasl Java SASL Programming Guide} * for information on how to use this API. * + * @spec https://www.rfc-editor.org/info/rfc2078 RFC 2078: Generic Security Service Application Program Interface, Version 2 + * @spec https://www.rfc-editor.org/info/rfc2222 RFC 2222: Simple Authentication and Security Layer (SASL) + * @spec https://www.rfc-editor.org/info/rfc2245 RFC 2245: Anonymous SASL Mechanism + * @spec https://www.rfc-editor.org/info/rfc2831 RFC 2831: Using Digest Authentication as a SASL Mechanism * @since 1.5 */ package javax.security.sasl; diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/URIReference.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/URIReference.java index 9034d86011cae..58f69410bfe43 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/URIReference.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/URIReference.java @@ -35,6 +35,7 @@ * and for objects of those types, the {@link #getType} method always returns * null. * + * @spec https://www.rfc-editor.org/info/rfc2396 RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax * @author Sean Mullan * @author JSR 105 Expert Group * @since 1.6 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dom/package-info.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dom/package-info.java index adb721bcc56b1..700c5d4e838c0 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dom/package-info.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dom/package-info.java @@ -41,6 +41,8 @@ * RFC 3275: XML-Signature Syntax and Processing * * + * @spec https://www.rfc-editor.org/info/rfc3275 RFC 3275: (Extensible Markup Language) XML-Signature Syntax and Processing + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @since 1.6 */ diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/CanonicalizationMethod.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/CanonicalizationMethod.java index 7f32518dc8c02..bb3d0d862c30c 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/CanonicalizationMethod.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/CanonicalizationMethod.java @@ -51,6 +51,7 @@ * the {@link XMLSignatureFactory#newCanonicalizationMethod * newCanonicalizationMethod} method of the {@link XMLSignatureFactory} class. * + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @author Sean Mullan * @author JSR 105 Expert Group * @since 1.6 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/DigestMethod.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/DigestMethod.java index e58c435950bef..a16551ee52966 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/DigestMethod.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/DigestMethod.java @@ -52,6 +52,7 @@ * {@link XMLSignatureFactory#newDigestMethod newDigestMethod} method * of the {@link XMLSignatureFactory} class. * + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @author Sean Mullan * @author JSR 105 Expert Group * @since 1.6 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/Manifest.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/Manifest.java index 9a117cf1ae8a4..c4511f87ed770 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/Manifest.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/Manifest.java @@ -56,6 +56,7 @@ * Manifest manifest = factory.newManifest(references, "manifest-1"); * * + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @author Sean Mullan * @author JSR 105 Expert Group * @since 1.6 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/Reference.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/Reference.java index dfa34796fb692..45f9f954f7ee3 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/Reference.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/Reference.java @@ -68,6 +68,7 @@ * factory.newDigestMethod(DigestMethod.SHA1, null)); * * + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @author Sean Mullan * @author Erwin van der Koogh * @author JSR 105 Expert Group diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/SignatureMethod.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/SignatureMethod.java index 5459045fec885..5e835cb396c15 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/SignatureMethod.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/SignatureMethod.java @@ -53,6 +53,7 @@ * {@link XMLSignatureFactory#newSignatureMethod newSignatureMethod} method * of the {@link XMLSignatureFactory} class. * + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @author Sean Mullan * @author JSR 105 Expert Group * @since 1.6 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/SignatureProperties.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/SignatureProperties.java index 947d7e3c939fd..616b2a11b4494 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/SignatureProperties.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/SignatureProperties.java @@ -55,6 +55,7 @@ * factory.newSignatureProperties(props, "signature-properties-1"); * * + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @author Sean Mullan * @author JSR 105 Expert Group * @since 1.6 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/SignatureProperty.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/SignatureProperty.java index 237590125b0e8..6eb166c73c344 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/SignatureProperty.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/SignatureProperty.java @@ -57,6 +57,7 @@ * (Collections.singletonList(content), "#Signature-1", "TimeStamp"); * * + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @author Sean Mullan * @author JSR 105 Expert Group * @since 1.6 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/SignedInfo.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/SignedInfo.java index 85cbb347ddba1..cbc6935a2fe4b 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/SignedInfo.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/SignedInfo.java @@ -52,6 +52,7 @@ * {@link XMLSignatureFactory#newSignedInfo newSignedInfo} methods of the * {@link XMLSignatureFactory} class. * + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @author Sean Mullan * @author JSR 105 Expert Group * @since 1.6 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/Transform.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/Transform.java index b9e6e97b7c918..ca702e10d9f0f 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/Transform.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/Transform.java @@ -58,6 +58,7 @@ * {@link XMLSignatureFactory#newTransform newTransform} method * of the {@link XMLSignatureFactory} class. * + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @author Sean Mullan * @author JSR 105 Expert Group * @since 1.6 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/XMLObject.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/XMLObject.java index 07bcb10334117..1a24101b56eb5 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/XMLObject.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/XMLObject.java @@ -73,6 +73,7 @@ * Object to avoid naming clashes with the existing * {@link java.lang.Object java.lang.Object} class. * + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @author Sean Mullan * @author JSR 105 Expert Group * @author Joyce L. Leung diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/XMLSignature.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/XMLSignature.java index 59ad8c8245e21..518c9435f44e7 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/XMLSignature.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/XMLSignature.java @@ -75,6 +75,7 @@ * Signature to avoid naming clashes with the existing * {@link Signature java.security.Signature} class. * + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @see XMLSignatureFactory#newXMLSignature(SignedInfo, KeyInfo) * @see XMLSignatureFactory#newXMLSignature(SignedInfo, KeyInfo, List, String, String) * @author Joyce L. Leung @@ -197,6 +198,7 @@ void sign(XMLSignContext signContext) throws MarshalException, * </complexType> * * + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @author Sean Mullan * @author JSR 105 Expert Group */ diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/dom/package-info.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/dom/package-info.java index 0a0c9413823e2..ef1dc278834fe 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/dom/package-info.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/dom/package-info.java @@ -41,6 +41,8 @@ * RFC 3275: XML-Signature Syntax and Processing * * + * @spec https://www.rfc-editor.org/info/rfc3275 RFC 3275: (Extensible Markup Language) XML-Signature Syntax and Processing + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @since 1.6 */ diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/KeyInfo.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/KeyInfo.java index b3e6d5e87151b..7c56695f57444 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/KeyInfo.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/KeyInfo.java @@ -72,6 +72,7 @@ *

    KeyInfo objects can also be marshalled to XML by invoking * the {@link #marshal marshal} method. * + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @author Sean Mullan * @author JSR 105 Expert Group * @since 1.6 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/KeyInfoFactory.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/KeyInfoFactory.java index be5e4cef3675b..a025164092e9e 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/KeyInfoFactory.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/KeyInfoFactory.java @@ -402,6 +402,7 @@ public abstract KeyInfo newKeyInfo(List content, * @throws NullPointerException if keyId is null * @throws IllegalArgumentException if the key id is not in the correct * format + * @spec https://www.rfc-editor.org/info/rfc2440 RFC 2440: OpenPGP Message Format */ public abstract PGPData newPGPData(byte[] keyId); @@ -429,6 +430,7 @@ public abstract KeyInfo newKeyInfo(List content, * contents and format of the packet body are not checked. * @throws ClassCastException if other contains any * entries that are not of type {@link XMLStructure} + * @spec https://www.rfc-editor.org/info/rfc2440 RFC 2440: OpenPGP Message Format */ public abstract PGPData newPGPData(byte[] keyId, byte[] keyPacket, List other); @@ -452,6 +454,7 @@ public abstract PGPData newPGPData(byte[] keyId, byte[] keyPacket, * material. The contents and format of the packet body are not checked. * @throws ClassCastException if other contains any * entries that are not of type {@link XMLStructure} + * @spec https://www.rfc-editor.org/info/rfc2440 RFC 2440: OpenPGP Message Format */ public abstract PGPData newPGPData(byte[] keyPacket, List other); diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/KeyName.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/KeyName.java index 50a17e11bc38d..165a9e5c086c4 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/KeyName.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/KeyName.java @@ -50,6 +50,7 @@ * KeyName keyName = factory.newKeyName("Alice"); * * + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @author Sean Mullan * @author JSR 105 Expert Group * @since 1.6 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/KeyValue.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/KeyValue.java index aab9237f5c75f..40be6770e5431 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/KeyValue.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/KeyValue.java @@ -119,6 +119,7 @@ * all of the fields in the schema are accessible as parameters of these * types. * + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @author Sean Mullan * @author JSR 105 Expert Group * @since 1.6 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/PGPData.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/PGPData.java index 3cf2ab5f6ee98..c0473fe075c66 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/PGPData.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/PGPData.java @@ -65,6 +65,7 @@ * identifier and/or PGP key material packet, and an optional list of * elements from an external namespace. * + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @author Sean Mullan * @author JSR 105 Expert Group * @since 1.6 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/RetrievalMethod.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/RetrievalMethod.java index 7a53f9e41a005..ec970e37aecae 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/RetrievalMethod.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/RetrievalMethod.java @@ -65,6 +65,7 @@ * ("#KeyValue-1", KeyValue.DSA_TYPE, Collections.singletonList(Transform.BASE64)); * * + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @author Sean Mullan * @author JSR 105 Expert Group * @since 1.6 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/X509Data.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/X509Data.java index 08ee348d5110f..2cccba6c0a400 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/X509Data.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/X509Data.java @@ -72,6 +72,7 @@ * (Collections.singletonList("cn=Alice")); * * + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @author Sean Mullan * @author JSR 105 Expert Group * @since 1.6 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/X509IssuerSerial.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/X509IssuerSerial.java index 91ab76933ae62..764edb83701c9 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/X509IssuerSerial.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/X509IssuerSerial.java @@ -62,6 +62,7 @@ * (cert.getIssuerX500Principal().getName(), cert.getSerialNumber()); * * + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @author Sean Mullan * @author JSR 105 Expert Group * @since 1.6 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/package-info.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/package-info.java index e68a9f0637e5f..387ebb7587c3e 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/package-info.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/package-info.java @@ -53,6 +53,8 @@ * RFC 3275: XML-Signature Syntax and Processing * * + * @spec https://www.rfc-editor.org/info/rfc3275 RFC 3275: (Extensible Markup Language) XML-Signature Syntax and Processing + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @since 1.6 */ diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/package-info.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/package-info.java index 0c4684ca7ba44..174cdd4adc256 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/package-info.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/package-info.java @@ -163,6 +163,8 @@ * RFC 3275: XML-Signature Syntax and Processing * * + * @spec https://www.rfc-editor.org/info/rfc3275 RFC 3275: (Extensible Markup Language) XML-Signature Syntax and Processing + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @since 1.6 */ diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/ExcC14NParameterSpec.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/ExcC14NParameterSpec.java index 45ff07f133532..a464dfc42df5c 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/ExcC14NParameterSpec.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/ExcC14NParameterSpec.java @@ -52,6 +52,7 @@ * </schema> * * + * @spec https://www.w3.org/TR/xml-exc-c14n Exclusive XML Canonicalization Version 1.0 * @author Sean Mullan * @author JSR 105 Expert Group * @since 1.6 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/HMACParameterSpec.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/HMACParameterSpec.java index 36850990c13e0..0a328e09fc5f8 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/HMACParameterSpec.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/HMACParameterSpec.java @@ -44,6 +44,8 @@ * </simpleType> * * + * @spec https://www.rfc-editor.org/info/rfc2104 RFC 2104: HMAC: Keyed-Hashing for Message Authentication + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @author Sean Mullan * @author JSR 105 Expert Group * @since 1.6 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/RSAPSSParameterSpec.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/RSAPSSParameterSpec.java index 47f9fe3aa733f..f736ee883d3bd 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/RSAPSSParameterSpec.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/RSAPSSParameterSpec.java @@ -65,6 +65,7 @@ * </xs:complexType> * * + * @spec https://www.rfc-editor.org/info/rfc6931 RFC 6931: Additional XML Security Uniform Resource Identifiers (URIs) * @since 17 * @see SignatureMethod#RSA_PSS * @see RFC 6931 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/XPathFilter2ParameterSpec.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/XPathFilter2ParameterSpec.java index acaa651e59785..23e3e3a5a2236 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/XPathFilter2ParameterSpec.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/XPathFilter2ParameterSpec.java @@ -38,6 +38,7 @@ * XPath Filter 2.0 Transform Algorithm. * The parameters include a list of one or more {@link XPathType} objects. * + * @spec https://www.w3.org/TR/xmldsig-filter2 XML-Signature XPath Filter 2.0 * @author Sean Mullan * @author JSR 105 Expert Group * @since 1.6 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/XPathFilterParameterSpec.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/XPathFilterParameterSpec.java index 1a0ed7e900bf7..32befe6703fdd 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/XPathFilterParameterSpec.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/XPathFilterParameterSpec.java @@ -43,6 +43,7 @@ * <element name="XPath" type="string"/> * * + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @author Sean Mullan * @author JSR 105 Expert Group * @since 1.6 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/XPathType.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/XPathType.java index 625eaab343e19..e72afd87b5cef 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/XPathType.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/XPathType.java @@ -61,6 +61,7 @@ * </complexType> * * + * @spec https://www.w3.org/TR/xmldsig-filter2 XML-Signature XPath Filter 2.0 * @author Sean Mullan * @author JSR 105 Expert Group * @since 1.6 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/XSLTTransformParameterSpec.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/XSLTTransformParameterSpec.java index 6a05b7783d284..cc7889ec8d906 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/XSLTTransformParameterSpec.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/XSLTTransformParameterSpec.java @@ -44,6 +44,7 @@ * where element is an {@link org.w3c.dom.Element} containing * the namespace-qualified stylesheet element. * + * @spec https://www.w3.org/TR/1999/REC-xslt-19991116 XSL Transformations (XSLT) * @author Sean Mullan * @author JSR 105 Expert Group * @since 1.6 diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/package-info.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/package-info.java index e6b6db3b915f5..8edca1186d4c2 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/package-info.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/package-info.java @@ -46,6 +46,10 @@ * XPath Filter 2.0 Transform Algorithm: W3C Recommendation * * + * @spec https://www.w3.org/TR/xml-exc-c14n Exclusive XML Canonicalization Version 1.0 + * @spec https://www.rfc-editor.org/info/rfc3275 RFC 3275: (Extensible Markup Language) XML-Signature Syntax and Processing + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 + * @spec https://www.w3.org/TR/xmldsig-filter2 XML-Signature XPath Filter 2.0 * @since 1.6 */ diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/package-info.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/package-info.java index 12aa6dd3cb30e..7d912a0fa01fd 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/package-info.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/package-info.java @@ -39,6 +39,8 @@ * RFC 3275: XML-Signature Syntax and Processing * * + * @spec https://www.rfc-editor.org/info/rfc3275 RFC 3275: (Extensible Markup Language) XML-Signature Syntax and Processing + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 * @since 1.6 */ diff --git a/src/java.xml/share/classes/javax/xml/XMLConstants.java b/src/java.xml/share/classes/javax/xml/XMLConstants.java index 7de589087e707..5d688df880a2f 100644 --- a/src/java.xml/share/classes/javax/xml/XMLConstants.java +++ b/src/java.xml/share/classes/javax/xml/XMLConstants.java @@ -28,6 +28,11 @@ /** *

    Utility class to contain basic XML values as constants. * + * @spec https://www.w3.org/TR/xml Extensible Markup Language (XML) 1.0 (Fifth Edition) + * @spec https://www.w3.org/TR/xml11 Extensible Markup Language (XML) 1.1 (Second Edition) + * @spec https://www.w3.org/TR/REC-xml-names Namespaces in XML 1.0 (Third Edition) + * @spec https://www.w3.org/TR/xml-names11 Namespaces in XML 1.1 (Second Edition) + * @spec https://www.w3.org/TR/xmlschema-1 XML Schema Part 1: Structures Second Edition * @author Jeff Suttor * @see Extensible Markup Language (XML) 1.1 * @see Extensible Markup Language (XML) 1.0 (Second Edition) @@ -51,6 +56,7 @@ private XMLConstants() { * *

    Defined by the Namespace specification to be "". * + * @spec https://www.w3.org/TR/REC-xml-names Namespaces in XML 1.0 (Third Edition) * @see * Namespaces in XML, 5.2 Namespace Defaulting */ @@ -61,6 +67,7 @@ private XMLConstants() { * *

    Defined by the XML specification to be "". * + * @spec https://www.w3.org/TR/REC-xml-names Namespaces in XML 1.0 (Third Edition) * @see * Namespaces in XML, 3. Qualified Names @@ -73,6 +80,7 @@ private XMLConstants() { *

    Defined by the XML specification to be * "{@code http://www.w3.org/XML/1998/namespace}". * + * @spec https://www.w3.org/TR/REC-xml-names Namespaces in XML 1.0 (Third Edition) * @see * Namespaces in XML, 3. Qualified Names @@ -85,6 +93,7 @@ private XMLConstants() { * *

    Defined by the XML specification to be "{@code xml}". * + * @spec https://www.w3.org/TR/REC-xml-names Namespaces in XML 1.0 (Third Edition) * @see * Namespaces in XML, 3. Qualified Names @@ -99,6 +108,7 @@ private XMLConstants() { *

    Defined by the XML specification to be * "{@code http://www.w3.org/2000/xmlns/}". * + * @spec https://www.w3.org/TR/REC-xml-names Namespaces in XML 1.0 (Third Edition) * @see * Namespaces in XML, 3. Qualified Names @@ -114,6 +124,7 @@ private XMLConstants() { * prefix. Defined by the XML specification to be * "{@code xmlns}". * + * @spec https://www.w3.org/TR/REC-xml-names Namespaces in XML 1.0 (Third Edition) * @see * Namespaces in XML, 3. Qualified Names @@ -125,6 +136,7 @@ private XMLConstants() { * *

    Defined to be "{@code http://www.w3.org/2001/XMLSchema}". * + * @spec https://www.w3.org/TR/xmlschema-1 XML Schema Part 1: Structures Second Edition * @see * XML Schema Part 1: @@ -138,6 +150,7 @@ private XMLConstants() { * *

    Defined to be "{@code http://www.w3.org/2001/XMLSchema-instance}". * + * @spec https://www.w3.org/TR/xmlschema-1 XML Schema Part 1: Structures Second Edition * @see * XML Schema Part 1: @@ -151,6 +164,7 @@ private XMLConstants() { * *

    Defined to be "{@code http://www.w3.org/2003/11/xpath-datatypes}". * + * @spec https://www.w3.org/TR/xpath-datamodel XQuery and XPath Data Model 3.1 * @see XQuery 1.0 and XPath 2.0 Data Model */ public static final String W3C_XPATH_DATATYPE_NS_URI = "http://www.w3.org/2003/11/xpath-datatypes"; diff --git a/src/java.xml/share/classes/javax/xml/datatype/DatatypeFactory.java b/src/java.xml/share/classes/javax/xml/datatype/DatatypeFactory.java index a75ad6a43570c..d4bb8c0484a12 100644 --- a/src/java.xml/share/classes/javax/xml/datatype/DatatypeFactory.java +++ b/src/java.xml/share/classes/javax/xml/datatype/DatatypeFactory.java @@ -237,6 +237,7 @@ public static DatatypeFactory newInstance(String factoryClassName, ClassLoader c * @param durationInMilliSeconds Duration in milliseconds to create. * * @return New {@code Duration} representing {@code durationInMilliSeconds}. + * @spec https://www.w3.org/TR/xmlschema-2 XML Schema Part 2: Datatypes Second Edition */ public abstract Duration newDuration(final long durationInMilliSeconds); @@ -368,6 +369,7 @@ public Duration newDuration( * not a valid representation of a {@code Duration} expressed only in terms of days and time. * @throws UnsupportedOperationException If implementation cannot support requested values. * @throws NullPointerException If {@code lexicalRepresentation} is {@code null}. + * @spec https://www.w3.org/TR/xpath-datamodel XQuery and XPath Data Model 3.1 */ public Duration newDurationDayTime(final String lexicalRepresentation) { // lexicalRepresentation must be non-null @@ -424,6 +426,8 @@ public Duration newDurationDayTime(final String lexicalRepresentation) { * * @return New {@code Duration} created with the specified {@code durationInMilliseconds}. * + * @spec https://www.w3.org/TR/xmlschema-2 XML Schema Part 2: Datatypes Second Edition + * @spec https://www.w3.org/TR/xpath-datamodel XQuery and XPath Data Model 3.1 * @see * XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration */ @@ -463,6 +467,7 @@ public Duration newDurationDayTime(final long durationInMilliseconds) { * {@code Duration}: if all the fields (day, hour, ...) are null or * if any of the fields is negative. * @throws UnsupportedOperationException If implementation cannot support requested values. + * @spec https://www.w3.org/TR/xpath-datamodel XQuery and XPath Data Model 3.1 */ public Duration newDurationDayTime( final boolean isPositive, @@ -506,6 +511,7 @@ public Duration newDurationDayTime( * * @throws IllegalArgumentException If the values are not a valid representation of a * {@code Duration}: if any of the fields (day, hour, ...) is negative. + * @spec https://www.w3.org/TR/xpath-datamodel XQuery and XPath Data Model 3.1 */ public Duration newDurationDayTime( final boolean isPositive, @@ -548,6 +554,7 @@ public Duration newDurationDayTime( * @throws IllegalArgumentException If {@code lexicalRepresentation} is not a valid representation of a {@code Duration} expressed only in terms of years and months. * @throws UnsupportedOperationException If implementation cannot support requested values. * @throws NullPointerException If {@code lexicalRepresentation} is {@code null}. + * @spec https://www.w3.org/TR/xpath-datamodel XQuery and XPath Data Model 3.1 */ public Duration newDurationYearMonth( final String lexicalRepresentation) { @@ -605,6 +612,8 @@ public Duration newDurationYearMonth( * @param durationInMilliseconds Milliseconds of {@code Duration} to create. * * @return New {@code Duration} created using the specified {@code durationInMilliseconds}. + * @spec https://www.w3.org/TR/xmlschema-2 XML Schema Part 2: Datatypes Second Edition + * @spec https://www.w3.org/TR/xpath-datamodel XQuery and XPath Data Model 3.1 */ public Duration newDurationYearMonth( final long durationInMilliseconds) { @@ -648,6 +657,7 @@ public Duration newDurationYearMonth( * {@code Duration}: if all of the fields (year, month) are null or * if any of the fields is negative. * @throws UnsupportedOperationException If implementation cannot support requested values. + * @spec https://www.w3.org/TR/xpath-datamodel XQuery and XPath Data Model 3.1 */ public Duration newDurationYearMonth( final boolean isPositive, @@ -682,6 +692,7 @@ public Duration newDurationYearMonth( * * @throws IllegalArgumentException If the values are not a valid representation of a * {@code Duration}: if any of the fields (year, month) is negative. + * @spec https://www.w3.org/TR/xpath-datamodel XQuery and XPath Data Model 3.1 */ public Duration newDurationYearMonth( final boolean isPositive, @@ -728,6 +739,7 @@ public Duration newDurationYearMonth( * * @throws IllegalArgumentException If the {@code lexicalRepresentation} is not a valid {@code XMLGregorianCalendar}. * @throws NullPointerException If {@code lexicalRepresentation} is {@code null}. + * @spec https://www.w3.org/TR/xmlschema-2 XML Schema Part 2: Datatypes Second Edition */ public abstract XMLGregorianCalendar newXMLGregorianCalendar(final String lexicalRepresentation); diff --git a/src/java.xml/share/classes/javax/xml/datatype/Duration.java b/src/java.xml/share/classes/javax/xml/datatype/Duration.java index cad8a56c58b09..4eb475ea81d54 100644 --- a/src/java.xml/share/classes/javax/xml/datatype/Duration.java +++ b/src/java.xml/share/classes/javax/xml/datatype/Duration.java @@ -758,6 +758,7 @@ public Duration multiply(int factor) { * implementations capability. * @throws NullPointerException if {@code duration} is {@code null}. * + * @spec https://www.w3.org/TR/xmlschema-2 XML Schema Part 2: Datatypes Second Edition * @see #isShorterThan(Duration) * @see #isLongerThan(Duration) */ diff --git a/src/java.xml/share/classes/javax/xml/datatype/XMLGregorianCalendar.java b/src/java.xml/share/classes/javax/xml/datatype/XMLGregorianCalendar.java index cbaa255387908..9b392c08ae904 100644 --- a/src/java.xml/share/classes/javax/xml/datatype/XMLGregorianCalendar.java +++ b/src/java.xml/share/classes/javax/xml/datatype/XMLGregorianCalendar.java @@ -166,6 +166,7 @@ * * * + * @spec https://www.w3.org/TR/xmlschema-2 XML Schema Part 2: Datatypes Second Edition * @author Joseph Fialli * @author Kohsuke Kawaguchi * @author Jeff Suttor @@ -660,6 +661,7 @@ public int getMillisecond() { * {@link DatatypeConstants#INDETERMINATE}. * * @throws NullPointerException if {@code xmlGregorianCalendar} is null. + * @spec https://www.w3.org/TR/xmlschema-2 XML Schema Part 2: Datatypes Second Edition */ public abstract int compare(XMLGregorianCalendar xmlGregorianCalendar); @@ -738,6 +740,7 @@ public int hashCode() { * * @throws IllegalStateException if the combination of set fields * does not match one of the eight defined XML Schema builtin date/time datatypes. + * @spec https://www.w3.org/TR/xmlschema-2 XML Schema Part 2: Datatypes Second Edition */ public abstract String toXMLFormat(); @@ -887,6 +890,7 @@ public String toString() { * @param duration Duration to add to this {@code XMLGregorianCalendar}. * * @throws NullPointerException when {@code duration} parameter is {@code null}. + * @spec https://www.w3.org/TR/xmlschema-2 XML Schema Part 2: Datatypes Second Edition */ public abstract void add(Duration duration); diff --git a/src/java.xml/share/classes/javax/xml/datatype/package-info.java b/src/java.xml/share/classes/javax/xml/datatype/package-info.java index 57b2cbe5ac9e2..fa8b9c0cd32a5 100644 --- a/src/java.xml/share/classes/javax/xml/datatype/package-info.java +++ b/src/java.xml/share/classes/javax/xml/datatype/package-info.java @@ -149,6 +149,8 @@ *

  • xs:unsignedShort
    • * * + * @spec https://www.w3.org/TR/xmlschema-2 XML Schema Part 2: Datatypes Second Edition + * @spec https://www.w3.org/TR/xpath-datamodel XQuery and XPath Data Model 3.1 * @author Jeff Suttor * @see * W3C XML Schema 1.0 Part 2, Section 3.2.7-14 diff --git a/src/java.xml/share/classes/javax/xml/namespace/NamespaceContext.java b/src/java.xml/share/classes/javax/xml/namespace/NamespaceContext.java index b978973541e6d..f278394bc4a05 100644 --- a/src/java.xml/share/classes/javax/xml/namespace/NamespaceContext.java +++ b/src/java.xml/share/classes/javax/xml/namespace/NamespaceContext.java @@ -67,6 +67,8 @@ *

    A prefix can only be bound to a single * Namespace URI in the current scope. * + * @spec https://www.w3.org/TR/REC-xml-names Namespaces in XML 1.0 (Third Edition) + * @spec https://www.w3.org/TR/xmlschema-2 XML Schema Part 2: Datatypes Second Edition * @author Jeff Suttor * @see javax.xml.XMLConstants * javax.xml.XMLConstants for declarations of common XML values diff --git a/src/java.xml/share/classes/javax/xml/namespace/QName.java b/src/java.xml/share/classes/javax/xml/namespace/QName.java index 94121d0d334d5..5a00b2d15ed5f 100644 --- a/src/java.xml/share/classes/javax/xml/namespace/QName.java +++ b/src/java.xml/share/classes/javax/xml/namespace/QName.java @@ -57,6 +57,8 @@ * *

    QName is immutable.

    * + * @spec https://www.w3.org/TR/REC-xml-names Namespaces in XML 1.0 (Third Edition) + * @spec https://www.w3.org/TR/xmlschema-2 XML Schema Part 2: Datatypes Second Edition * @author Jeff Suttor * @see * XML Schema Part2: Datatypes specification @@ -121,6 +123,8 @@ public class QName implements Serializable { * @throws IllegalArgumentException When localPart is * null * + * @spec https://www.w3.org/TR/REC-xml-names Namespaces in XML 1.0 (Third Edition) + * @spec https://www.rfc-editor.org/info/rfc2396 RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax * @see #QName(String namespaceURI, String localPart, String * prefix) QName(String namespaceURI, String localPart, String * prefix) @@ -168,6 +172,8 @@ public QName(final String namespaceURI, final String localPart) { * * @throws IllegalArgumentException When localPart * or prefix is null + * @spec https://www.w3.org/TR/REC-xml-names Namespaces in XML 1.0 (Third Edition) + * @spec https://www.rfc-editor.org/info/rfc2396 RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax */ public QName(String namespaceURI, String localPart, String prefix) { @@ -228,6 +234,7 @@ public QName(String namespaceURI, String localPart, String prefix) { * @throws IllegalArgumentException When localPart is * null * + * @spec https://www.w3.org/TR/REC-xml-names Namespaces in XML 1.0 (Third Edition) * @see #QName(String namespaceURI, String localPart) QName(String * namespaceURI, String localPart) * @see #QName(String namespaceURI, String localPart, String @@ -403,6 +410,8 @@ public String toString() { * null or malformed * * @return QName corresponding to the given String + * @spec https://www.w3.org/TR/REC-xml-names Namespaces in XML 1.0 (Third Edition) + * @spec https://www.rfc-editor.org/info/rfc2396 RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax * @see #toString() QName.toString() */ public static QName valueOf(String qNameAsString) { diff --git a/src/java.xml/share/classes/javax/xml/namespace/package-info.java b/src/java.xml/share/classes/javax/xml/namespace/package-info.java index b7c23a62922d2..c31bc8631e948 100644 --- a/src/java.xml/share/classes/javax/xml/namespace/package-info.java +++ b/src/java.xml/share/classes/javax/xml/namespace/package-info.java @@ -43,6 +43,8 @@ * * * + * @spec https://www.w3.org/TR/REC-xml-names Namespaces in XML 1.0 (Third Edition) + * @spec https://www.w3.org/TR/xmlschema-2 XML Schema Part 2: Datatypes Second Edition * @since 1.5 */ diff --git a/src/java.xml/share/classes/javax/xml/parsers/DocumentBuilderFactory.java b/src/java.xml/share/classes/javax/xml/parsers/DocumentBuilderFactory.java index 051f892a77c77..0c4f13d5e0efa 100644 --- a/src/java.xml/share/classes/javax/xml/parsers/DocumentBuilderFactory.java +++ b/src/java.xml/share/classes/javax/xml/parsers/DocumentBuilderFactory.java @@ -270,6 +270,7 @@ public void setNamespaceAware(boolean awareness) { * * @param validating true if the parser produced will validate documents * as they are parsed; false otherwise. + * @spec https://www.w3.org/TR/xml Extensible Markup Language (XML) 1.0 (Fifth Edition) */ public void setValidating(boolean validating) { @@ -630,6 +631,7 @@ public void setSchema(Schema schema) { * @throws UnsupportedOperationException When implementation does not * override this method. * + * @spec https://www.w3.org/TR/xinclude XML Inclusions (XInclude) Version 1.0 (Second Edition) * @since 1.5 */ public void setXIncludeAware(final boolean state) { diff --git a/src/java.xml/share/classes/javax/xml/parsers/SAXParserFactory.java b/src/java.xml/share/classes/javax/xml/parsers/SAXParserFactory.java index 9c5b1c0f5a904..9930cd586dcf4 100644 --- a/src/java.xml/share/classes/javax/xml/parsers/SAXParserFactory.java +++ b/src/java.xml/share/classes/javax/xml/parsers/SAXParserFactory.java @@ -280,6 +280,7 @@ public void setNamespaceAware(boolean awareness) { * * @param validating true if the parser produced by this code will * validate documents as they are parsed; false otherwise. + * @spec https://www.w3.org/TR/xml Extensible Markup Language (XML) 1.0 (Fifth Edition) */ public void setValidating(boolean validating) { @@ -467,6 +468,7 @@ public void setSchema(Schema schema) { * @throws UnsupportedOperationException When implementation does not * override this method * + * @spec https://www.w3.org/TR/xinclude XML Inclusions (XInclude) Version 1.0 (Second Edition) * @since 1.5 */ public void setXIncludeAware(final boolean state) { diff --git a/src/java.xml/share/classes/javax/xml/stream/XMLStreamReader.java b/src/java.xml/share/classes/javax/xml/stream/XMLStreamReader.java index 7915d387a5ec8..b41810e20fc68 100644 --- a/src/java.xml/share/classes/javax/xml/stream/XMLStreamReader.java +++ b/src/java.xml/share/classes/javax/xml/stream/XMLStreamReader.java @@ -330,6 +330,7 @@ public interface XMLStreamReader extends XMLStreamConstants { * @param prefix The prefix to lookup, may not be null * @return the uri bound to the given prefix or null if it is not bound * @throws IllegalArgumentException if the prefix is null + * @spec https://www.w3.org/TR/REC-xml-names Namespaces in XML 1.0 (Third Edition) */ public String getNamespaceURI(String prefix); diff --git a/src/java.xml/share/classes/javax/xml/transform/OutputKeys.java b/src/java.xml/share/classes/javax/xml/transform/OutputKeys.java index 83f4ff4e3fadb..f51ae05272d11 100644 --- a/src/java.xml/share/classes/javax/xml/transform/OutputKeys.java +++ b/src/java.xml/share/classes/javax/xml/transform/OutputKeys.java @@ -31,6 +31,7 @@ * output properties from a Transformer or Templates object. *

    All the fields in this class are read-only.

    * + * @spec https://www.w3.org/TR/xslt xslt cover page - W3C * @see * section 16 of the XSL Transformations (XSLT) W3C Recommendation * @since 1.4 @@ -55,6 +56,7 @@ private OutputKeys() { } * or {@link javax.xml.transform.Transformer#setOutputProperties} will * throw a {@link java.lang.IllegalArgumentException}.

    * + * @spec https://www.w3.org/TR/xslt xslt cover page - W3C * @see * section 16 of the XSL Transformations (XSLT) W3C Recommendation */ @@ -73,6 +75,7 @@ private OutputKeys() { } * that the result should be output as HTML conforming to the HTML 4.0 * Recommendation [HTML]. If the output method is "text", the version * property is ignored.

    + * @spec https://www.w3.org/TR/xslt xslt cover page - W3C * @see * section 16 of the XSL Transformations (XSLT) W3C Recommendation */ @@ -90,6 +93,8 @@ private OutputKeys() { } * Assigned Numbers Authority [IANA], * [RFC2278] * or start with X-.

    + * @spec https://www.rfc-editor.org/info/rfc2278 RFC 2278: IANA Charset Registration Procedures + * @spec https://www.w3.org/TR/xslt xslt cover page - W3C * @see * section 16 of the XSL Transformations (XSLT) W3C Recommendation */ @@ -101,6 +106,7 @@ private OutputKeys() { } *

    omit-xml-declaration specifies whether the XSLT * processor should output an XML declaration; the value must be * yes or no.

    + * @spec https://www.w3.org/TR/xslt xslt cover page - W3C * @see * section 16 of the XSL Transformations (XSLT) W3C Recommendation */ @@ -112,6 +118,7 @@ private OutputKeys() { } *

    standalone specifies whether the Transformer * should output a standalone document declaration; the value must be * yes or no.

    + * @spec https://www.w3.org/TR/xslt xslt cover page - W3C * @see * section 16 of the XSL Transformations (XSLT) W3C Recommendation */ @@ -122,6 +129,7 @@ private OutputKeys() { } *

    See the documentation for the {@link #DOCTYPE_SYSTEM} property * for a description of what the value of the key should be.

    * + * @spec https://www.w3.org/TR/xslt xslt cover page - W3C * @see * section 16 of the XSL Transformations (XSLT) W3C Recommendation */ @@ -153,6 +161,7 @@ private OutputKeys() { } * *

    doctype-system specifies the system identifier * to be used in the document type declaration.

    + * @spec https://www.w3.org/TR/xslt xslt cover page - W3C * @see * section 16 of the XSL Transformations (XSLT) W3C Recommendation */ @@ -167,6 +176,7 @@ private OutputKeys() { } * described in the section Qualified Name Representation in * {@link javax.xml.transform}.

    * + * @spec https://www.w3.org/TR/xslt xslt cover page - W3C * @see * section 16 of the XSL Transformations (XSLT) W3C Recommendation. */ @@ -179,6 +189,7 @@ private OutputKeys() { } *

    indent specifies whether the Transformer may * add additional whitespace when outputting the result tree; the value * must be yes or no.

    + * @spec https://www.w3.org/TR/xslt xslt cover page - W3C * @see * section 16 of the XSL Transformations (XSLT) W3C Recommendation */ @@ -194,6 +205,7 @@ private OutputKeys() { } * text, a charset parameter should be added * according to the character encoding actually used by the output * method.

    + * @spec https://www.w3.org/TR/xslt xslt cover page - W3C * @see s * ection 16 of the XSL Transformations (XSLT) W3C Recommendation */ diff --git a/src/java.xml/share/classes/javax/xml/transform/Result.java b/src/java.xml/share/classes/javax/xml/transform/Result.java index 45ee63582e3c0..39a75aba9b87d 100644 --- a/src/java.xml/share/classes/javax/xml/transform/Result.java +++ b/src/java.xml/share/classes/javax/xml/transform/Result.java @@ -51,6 +51,7 @@ public interface Result { *

    Result DOM trees may also have PI_DISABLE_OUTPUT_ESCAPING and * PI_ENABLE_OUTPUT_ESCAPING inserted into the tree. * + * @spec https://www.w3.org/TR/xslt xslt cover page - W3C * @see disable-output-escaping in XSLT Specification */ public static final String PI_DISABLE_OUTPUT_ESCAPING = @@ -61,6 +62,7 @@ public interface Result { * if the result tree enables output escaping at some point after having * received a PI_DISABLE_OUTPUT_ESCAPING processing instruction. * + * @spec https://www.w3.org/TR/xslt xslt cover page - W3C * @see disable-output-escaping in XSLT Specification */ public static final String PI_ENABLE_OUTPUT_ESCAPING = diff --git a/src/java.xml/share/classes/javax/xml/transform/Transformer.java b/src/java.xml/share/classes/javax/xml/transform/Transformer.java index 5f6bd11eafca4..50127fe3541d2 100644 --- a/src/java.xml/share/classes/javax/xml/transform/Transformer.java +++ b/src/java.xml/share/classes/javax/xml/transform/Transformer.java @@ -259,6 +259,7 @@ public abstract void transform(Source xmlSource, Result outputTarget) * @return A copy of the set of output properties in effect for * the next transformation. * + * @spec https://www.w3.org/TR/xslt xslt cover page - W3C * @see javax.xml.transform.OutputKeys * @see java.util.Properties * @see diff --git a/src/java.xml/share/classes/javax/xml/transform/TransformerFactory.java b/src/java.xml/share/classes/javax/xml/transform/TransformerFactory.java index 20470fa4ad84b..806b998de2831 100644 --- a/src/java.xml/share/classes/javax/xml/transform/TransformerFactory.java +++ b/src/java.xml/share/classes/javax/xml/transform/TransformerFactory.java @@ -157,6 +157,7 @@ public static TransformerFactory newInstance(String factoryClassName, ClassLoade * parsing the {@code Source} or it is not possible to create a * {@code Transformer} instance. * + * @spec https://www.w3.org/TR/xslt xslt cover page - W3C * @see * XSL Transformations (XSLT) Version 1.0 */ @@ -218,6 +219,7 @@ public abstract Templates newTemplates(Source source) * is thrown if an error occurings during parsing of the * {@code source}. * + * @spec https://www.w3.org/TR/xml-stylesheet Associating Style Sheets with XML documents 1.0 (Second Edition) * @see * Associating Style Sheets with XML documents Version 1.0 */ diff --git a/src/java.xml/share/classes/javax/xml/transform/dom/DOMSource.java b/src/java.xml/share/classes/javax/xml/transform/dom/DOMSource.java index b5adcb8eca1de..43974ec8584e2 100644 --- a/src/java.xml/share/classes/javax/xml/transform/dom/DOMSource.java +++ b/src/java.xml/share/classes/javax/xml/transform/dom/DOMSource.java @@ -38,6 +38,7 @@ * Parsers can be made namespace aware by calling * {@link javax.xml.parsers.DocumentBuilderFactory#setNamespaceAware(boolean awareness)}.

    * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @author Jeff Suttor * @see Document Object Model (DOM) Level 2 Specification * @since 1.4 diff --git a/src/java.xml/share/classes/javax/xml/transform/dom/package-info.java b/src/java.xml/share/classes/javax/xml/transform/dom/package-info.java index 6a121ce46c13e..0e0152c21985d 100644 --- a/src/java.xml/share/classes/javax/xml/transform/dom/package-info.java +++ b/src/java.xml/share/classes/javax/xml/transform/dom/package-info.java @@ -55,6 +55,7 @@ * like do not make much sense for a DOM), so the result of getLocator must always * be tested with an instanceof. * + * @spec https://www.w3.org/TR/xslt xslt cover page - W3C * @since 1.5 */ diff --git a/src/java.xml/share/classes/javax/xml/transform/package-info.java b/src/java.xml/share/classes/javax/xml/transform/package-info.java index 1345258f64e46..2c7b0b034a4d5 100644 --- a/src/java.xml/share/classes/javax/xml/transform/package-info.java +++ b/src/java.xml/share/classes/javax/xml/transform/package-info.java @@ -203,6 +203,8 @@ * The returned {@link javax.xml.transform.Source} object must be usable by * the transformer, as specified in its implemented features. * + * @spec https://www.w3.org/TR/REC-xml-names Namespaces in XML 1.0 (Third Edition) + * @spec https://www.w3.org/TR/xslt xslt cover page - W3C * @since 1.5 */ diff --git a/src/java.xml/share/classes/javax/xml/validation/Schema.java b/src/java.xml/share/classes/javax/xml/validation/Schema.java index a883cf9dafd08..b0b6cd70d6679 100644 --- a/src/java.xml/share/classes/javax/xml/validation/Schema.java +++ b/src/java.xml/share/classes/javax/xml/validation/Schema.java @@ -58,6 +58,9 @@ * In other words, if you parse the same schema twice, you may * still get !schemaA.equals(schemaB). * + * @spec https://www.w3.org/TR/xml Extensible Markup Language (XML) 1.0 (Fifth Edition) + * @spec https://www.w3.org/TR/xml11 Extensible Markup Language (XML) 1.1 (Second Edition) + * @spec https://www.w3.org/TR/xmlschema-1 XML Schema Part 1: Structures Second Edition * @author Kohsuke Kawaguchi * @see XML Schema Part 1: Structures * @see Extensible Markup Language (XML) 1.1 diff --git a/src/java.xml/share/classes/javax/xml/validation/SchemaFactory.java b/src/java.xml/share/classes/javax/xml/validation/SchemaFactory.java index 260ffa652fefc..86d18cc518ceb 100644 --- a/src/java.xml/share/classes/javax/xml/validation/SchemaFactory.java +++ b/src/java.xml/share/classes/javax/xml/validation/SchemaFactory.java @@ -105,6 +105,7 @@ * * * + * @spec https://www.w3.org/TR/xmlschema-1 XML Schema Part 1: Structures Second Edition * @author Kohsuke Kawaguchi * @author Neeraj Bajaj * @@ -128,6 +129,7 @@ protected SchemaFactory() { * Creates a new instance of the {@code SchemaFactory} builtin * system-default implementation. * + * @spec https://www.w3.org/TR/xmlschema-1 XML Schema Part 1: Structures Second Edition * @implSpec The {@code SchemaFactory} builtin * system-default implementation is only required to support the * W3C XML Schema 1.0, diff --git a/src/java.xml/share/classes/javax/xml/xpath/XPath.java b/src/java.xml/share/classes/javax/xml/xpath/XPath.java index afdc667040fc1..62b56fa2bd50d 100644 --- a/src/java.xml/share/classes/javax/xml/xpath/XPath.java +++ b/src/java.xml/share/classes/javax/xml/xpath/XPath.java @@ -98,6 +98,7 @@ * method is invoked, applications may not recursively call * the {@code evaluate} method. * + * @spec https://www.w3.org/TR/xpath xpath cover page - W3C * @author Norman Walsh * @author Jeff Suttor * @see XML Path Language (XPath) Version 1.0 diff --git a/src/java.xml/share/classes/javax/xml/xpath/XPathConstants.java b/src/java.xml/share/classes/javax/xml/xpath/XPathConstants.java index 762673036032b..1729b968a205a 100644 --- a/src/java.xml/share/classes/javax/xml/xpath/XPathConstants.java +++ b/src/java.xml/share/classes/javax/xml/xpath/XPathConstants.java @@ -30,6 +30,7 @@ /** *

    XPath constants.

    * + * @spec https://www.w3.org/TR/xpath xpath cover page - W3C * @author Norman Walsh * @author Jeff Suttor * @see XML Path Language (XPath) Version 1.0 diff --git a/src/java.xml/share/classes/javax/xml/xpath/XPathEvaluationResult.java b/src/java.xml/share/classes/javax/xml/xpath/XPathEvaluationResult.java index fe3ea0de90752..6d962aa0c6284 100644 --- a/src/java.xml/share/classes/javax/xml/xpath/XPathEvaluationResult.java +++ b/src/java.xml/share/classes/javax/xml/xpath/XPathEvaluationResult.java @@ -34,6 +34,7 @@ * defined in XML Path Language (XPath) Version 1.0. * * @param the object type returned by the XPath evaluation. + * @spec https://www.w3.org/TR/xpath xpath cover page - W3C * @see XML Path Language (XPath) Version * 1.0 * diff --git a/src/java.xml/share/classes/javax/xml/xpath/XPathExpression.java b/src/java.xml/share/classes/javax/xml/xpath/XPathExpression.java index 257844e374942..c9c3de5f763b3 100644 --- a/src/java.xml/share/classes/javax/xml/xpath/XPathExpression.java +++ b/src/java.xml/share/classes/javax/xml/xpath/XPathExpression.java @@ -94,6 +94,7 @@ * method is invoked, applications may not recursively call * the {@code evaluate} method. * + * @spec https://www.w3.org/TR/xpath xpath cover page - W3C * @author Norman Walsh * @author Jeff Suttor * @see XML Path Language (XPath) Version 1.0, Expressions diff --git a/src/java.xml/share/classes/javax/xml/xpath/XPathFunctionResolver.java b/src/java.xml/share/classes/javax/xml/xpath/XPathFunctionResolver.java index f1132ebdb7b5f..0f2c3b68f4972 100644 --- a/src/java.xml/share/classes/javax/xml/xpath/XPathFunctionResolver.java +++ b/src/java.xml/share/classes/javax/xml/xpath/XPathFunctionResolver.java @@ -44,6 +44,8 @@ *

    If you wish to implement additional built-in functions, you will have to * extend the underlying implementation directly.

    * + * @spec https://www.w3.org/TR/xmldsig-core XML Signature Syntax and Processing Version 1.1 + * @spec https://www.w3.org/TR/xpath xpath cover page - W3C * @author Norman Walsh * @author Jeff Suttor * @see XML Path Language (XPath) Version 1.0, Core Function Library diff --git a/src/java.xml/share/classes/javax/xml/xpath/XPathNodes.java b/src/java.xml/share/classes/javax/xml/xpath/XPathNodes.java index 4fa7352782540..487e9d5c268fe 100644 --- a/src/java.xml/share/classes/javax/xml/xpath/XPathNodes.java +++ b/src/java.xml/share/classes/javax/xml/xpath/XPathNodes.java @@ -33,6 +33,7 @@ * in XML Path Language (XPath) * Version 1.0, 3.3 Node-sets. * + * @spec https://www.w3.org/TR/xpath xpath cover page - W3C * @since 9 */ public interface XPathNodes extends Iterable { diff --git a/src/java.xml/share/classes/javax/xml/xpath/package-info.java b/src/java.xml/share/classes/javax/xml/xpath/package-info.java index dd8a9b3674f76..94f367abeb0af 100644 --- a/src/java.xml/share/classes/javax/xml/xpath/package-info.java +++ b/src/java.xml/share/classes/javax/xml/xpath/package-info.java @@ -409,6 +409,7 @@ * * * + * @spec https://www.w3.org/TR/xpath xpath cover page - W3C * @since 1.5 * */ diff --git a/src/java.xml/share/classes/org/w3c/dom/Attr.java b/src/java.xml/share/classes/org/w3c/dom/Attr.java index 7f3d196d461b9..541fa8dc11c92 100644 --- a/src/java.xml/share/classes/org/w3c/dom/Attr.java +++ b/src/java.xml/share/classes/org/w3c/dom/Attr.java @@ -187,6 +187,8 @@ * * *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) */ public interface Attr extends Node { /** @@ -220,6 +222,7 @@ public interface Attr extends Node { * implementations, may do normalization automatically, even after * mutation; in such case, the value on retrieval may differ from the * value on setting. + * @spec https://www.w3.org/TR/2003/REC-SVG11-20030114 Scalable Vector Graphics (SVG) 1.1 Specification */ public String getValue(); /** @@ -237,6 +240,7 @@ public interface Attr extends Node { * value on setting. * @exception DOMException * NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly. + * @spec https://www.w3.org/TR/2003/REC-SVG11-20030114 Scalable Vector Graphics (SVG) 1.1 Specification */ public void setValue(String value) throws DOMException; @@ -302,6 +306,8 @@ public void setValue(String value) * reevaluated in accordance to the schema used. As a consequence, if * the Attr.schemaTypeInfo attribute contains an ID type, * isId will always return true. + * @spec https://www.w3.org/TR/2001/REC-xmlschema-1-20010502 XML Schema Part 1: Structures + * @spec https://www.w3.org/TR/2003/REC-xptr-framework-20030325 XPointer Framework * @since 1.5, DOM Level 3 */ public boolean isId(); diff --git a/src/java.xml/share/classes/org/w3c/dom/CDATASection.java b/src/java.xml/share/classes/org/w3c/dom/CDATASection.java index f973003d268d8..228401b8c0da8 100644 --- a/src/java.xml/share/classes/org/w3c/dom/CDATASection.java +++ b/src/java.xml/share/classes/org/w3c/dom/CDATASection.java @@ -78,6 +78,8 @@ * exception when a character is missing from the encoding, making the task * of ensuring that data is not corrupted on serialization more difficult. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) */ public interface CDATASection extends Text { } diff --git a/src/java.xml/share/classes/org/w3c/dom/CharacterData.java b/src/java.xml/share/classes/org/w3c/dom/CharacterData.java index 46618c8832253..39902151ea8ca 100644 --- a/src/java.xml/share/classes/org/w3c/dom/CharacterData.java +++ b/src/java.xml/share/classes/org/w3c/dom/CharacterData.java @@ -54,6 +54,7 @@ * the following, the term 16-bit units is used whenever necessary to * indicate that indexing on CharacterData is done in 16-bit units. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification */ public interface CharacterData extends Node { /** diff --git a/src/java.xml/share/classes/org/w3c/dom/Comment.java b/src/java.xml/share/classes/org/w3c/dom/Comment.java index 61bb67d4ae096..6363c2fe5db9c 100644 --- a/src/java.xml/share/classes/org/w3c/dom/Comment.java +++ b/src/java.xml/share/classes/org/w3c/dom/Comment.java @@ -54,6 +54,8 @@ * presence of this character sequence must generate a fatal error during * serialization. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) */ public interface Comment extends CharacterData { } diff --git a/src/java.xml/share/classes/org/w3c/dom/DOMConfiguration.java b/src/java.xml/share/classes/org/w3c/dom/DOMConfiguration.java index 320ca42b59290..e75dfa9ed86f0 100644 --- a/src/java.xml/share/classes/org/w3c/dom/DOMConfiguration.java +++ b/src/java.xml/share/classes/org/w3c/dom/DOMConfiguration.java @@ -383,6 +383,15 @@ * set, Document.normalizeDocument() will invoke the resource * resolver instead of using Document.documentURI. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/2001/REC-xml-c14n-20010315 Canonical XML + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification + * @spec https://www.w3.org/TR/DOM-Level-3-LS Document Object Model (DOM) Level 3 Load and Save Specification + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) + * @spec https://www.w3.org/TR/2004/REC-xml11-20040204 Extensible Markup Language (XML) 1.1 + * @spec https://www.w3.org/TR/1999/REC-xml-names-19990114 Namespaces in XML + * @spec https://www.w3.org/TR/2004/REC-xml-names11-20040204 Namespaces in XML 1.1 + * @spec https://www.w3.org/TR/2004/REC-xml-infoset-20040204 XML Information Set (Second Edition) + * @spec https://www.w3.org/TR/2001/REC-xmlschema-1-20010502 XML Schema Part 1: Structures * @since 1.5, DOM Level 3 */ public interface DOMConfiguration { diff --git a/src/java.xml/share/classes/org/w3c/dom/DOMError.java b/src/java.xml/share/classes/org/w3c/dom/DOMError.java index c0a00cd5c3c1e..f09fc0ebebfde 100644 --- a/src/java.xml/share/classes/org/w3c/dom/DOMError.java +++ b/src/java.xml/share/classes/org/w3c/dom/DOMError.java @@ -44,6 +44,7 @@ /** * DOMError is an interface that describes an error. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification * @since 1.5, DOM Level 3 */ public interface DOMError { diff --git a/src/java.xml/share/classes/org/w3c/dom/DOMErrorHandler.java b/src/java.xml/share/classes/org/w3c/dom/DOMErrorHandler.java index 82e9988deff4b..2f4251e253e44 100644 --- a/src/java.xml/share/classes/org/w3c/dom/DOMErrorHandler.java +++ b/src/java.xml/share/classes/org/w3c/dom/DOMErrorHandler.java @@ -53,6 +53,7 @@ *

    The application that is using the DOM implementation is expected to * implement this interface. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification * @since 1.5, DOM Level 3 */ public interface DOMErrorHandler { diff --git a/src/java.xml/share/classes/org/w3c/dom/DOMException.java b/src/java.xml/share/classes/org/w3c/dom/DOMException.java index 679c6a7c3639e..4ae0a6ff97166 100644 --- a/src/java.xml/share/classes/org/w3c/dom/DOMException.java +++ b/src/java.xml/share/classes/org/w3c/dom/DOMException.java @@ -58,6 +58,7 @@ * methods may return error codes similar to those listed in the * corresponding method descriptions. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification */ public class DOMException extends RuntimeException { public DOMException(short code, String message) { @@ -147,6 +148,7 @@ public DOMException(short code, String message) { * with respect to "partial validity", this exception would be raised * and the operation would not be done. This code is used in [DOM Level 3 Validation] * . Refer to this specification for further information. + * @spec https://www.w3.org/TR/2004/REC-DOM-Level-3-Val-20040127 Document Object Model (DOM) Level 3 Validation Specification * @since 1.5, DOM Level 3 */ public static final short VALIDATION_ERR = 16; diff --git a/src/java.xml/share/classes/org/w3c/dom/DOMImplementation.java b/src/java.xml/share/classes/org/w3c/dom/DOMImplementation.java index 2bcd5f7d39c21..d573ca020758e 100644 --- a/src/java.xml/share/classes/org/w3c/dom/DOMImplementation.java +++ b/src/java.xml/share/classes/org/w3c/dom/DOMImplementation.java @@ -46,6 +46,7 @@ * for performing operations that are independent of any particular instance * of the document object model. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification */ public interface DOMImplementation { /** @@ -55,6 +56,7 @@ public interface DOMImplementation { * @param version This is the version number of the feature to test. * @return true if the feature is implemented in the * specified version, false otherwise. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification */ public boolean hasFeature(String feature, String version); @@ -77,6 +79,8 @@ public boolean hasFeature(String feature, *
    NOT_SUPPORTED_ERR: May be raised if the implementation does not * support the feature "XML" and the language exposed through the * Document does not support XML Namespaces (such as [HTML 4.01]). + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) + * @spec https://www.w3.org/TR/html4 HTML 4.01 Specification * @since 1.4, DOM Level 2 */ public DocumentType createDocumentType(String qualifiedName, @@ -129,6 +133,10 @@ public DocumentType createDocumentType(String qualifiedName, *
    NOT_SUPPORTED_ERR: May be raised if the implementation does not * support the feature "XML" and the language exposed through the * Document does not support XML Namespaces (such as [HTML 4.01]). + * @spec https://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109 Document Object Model (DOM) Level 2 HTML Specification + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) + * @spec https://www.w3.org/TR/html4 HTML 4.01 Specification + * @spec https://www.w3.org/TR/1999/REC-xml-names-19990114 Namespaces in XML * @since 1.4, DOM Level 2 */ public Document createDocument(String namespaceURI, @@ -157,6 +165,7 @@ public Document createDocument(String namespaceURI, * return results inconsistent with the primary core * DOMImplementation such as hasFeature, * getFeature, etc. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification * @since 1.5, DOM Level 3 */ public Object getFeature(String feature, diff --git a/src/java.xml/share/classes/org/w3c/dom/DOMImplementationList.java b/src/java.xml/share/classes/org/w3c/dom/DOMImplementationList.java index 1fb2caa9b7d35..b71879a6638a6 100644 --- a/src/java.xml/share/classes/org/w3c/dom/DOMImplementationList.java +++ b/src/java.xml/share/classes/org/w3c/dom/DOMImplementationList.java @@ -48,6 +48,7 @@ * DOMImplementationList are accessible via an integral index, * starting from 0. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification * @since 1.5, DOM Level 3 */ public interface DOMImplementationList { diff --git a/src/java.xml/share/classes/org/w3c/dom/DOMImplementationSource.java b/src/java.xml/share/classes/org/w3c/dom/DOMImplementationSource.java index 317c4ba660072..c3843bea041be 100644 --- a/src/java.xml/share/classes/org/w3c/dom/DOMImplementationSource.java +++ b/src/java.xml/share/classes/org/w3c/dom/DOMImplementationSource.java @@ -49,6 +49,7 @@ * listed in the binding-specific list of available sources so that its * DOMImplementation objects are made available. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification * @since 1.5, DOM Level 3 */ public interface DOMImplementationSource { diff --git a/src/java.xml/share/classes/org/w3c/dom/DOMLocator.java b/src/java.xml/share/classes/org/w3c/dom/DOMLocator.java index ece7db191b0cf..720026af8fb66 100644 --- a/src/java.xml/share/classes/org/w3c/dom/DOMLocator.java +++ b/src/java.xml/share/classes/org/w3c/dom/DOMLocator.java @@ -45,6 +45,7 @@ * DOMLocator is an interface that describes a location (e.g. * where an error occurred). *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification * @since 1.5, DOM Level 3 */ public interface DOMLocator { diff --git a/src/java.xml/share/classes/org/w3c/dom/DOMStringList.java b/src/java.xml/share/classes/org/w3c/dom/DOMStringList.java index 50d045b9d81f0..1ff0f4235e398 100644 --- a/src/java.xml/share/classes/org/w3c/dom/DOMStringList.java +++ b/src/java.xml/share/classes/org/w3c/dom/DOMStringList.java @@ -48,6 +48,7 @@ * DOMStringList are accessible via an integral index, starting * from 0. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification * @since 1.5, DOM Level 3 */ public interface DOMStringList { diff --git a/src/java.xml/share/classes/org/w3c/dom/Document.java b/src/java.xml/share/classes/org/w3c/dom/Document.java index df10e9d9ae56d..51470b551c0eb 100644 --- a/src/java.xml/share/classes/org/w3c/dom/Document.java +++ b/src/java.xml/share/classes/org/w3c/dom/Document.java @@ -52,6 +52,7 @@ * ownerDocument attribute which associates them with the * Document within whose context they were created. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification */ public interface Document extends Node { /** @@ -73,6 +74,7 @@ public interface Document extends Node { * changing it afterwards is very unlikely to result in a change of the * features supported. * + * @spec https://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109 Document Object Model (DOM) Level 2 HTML Specification * @since 1.4, DOM Level 3 */ public DocumentType getDoctype(); @@ -337,6 +339,7 @@ public EntityReference createEntityReference(String name) * Document.xmlVersion attribute. This may happen when * importing an XML 1.1 [XML 1.1] element * into an XML 1.0 document, for instance. + * @spec https://www.w3.org/TR/2004/REC-xml11-20040204 Extensible Markup Language (XML) 1.1 * @since 1.4, DOM Level 2 */ public Node importNode(Node importedNode, @@ -406,6 +409,7 @@ public Node importNode(Node importedNode, *
    NOT_SUPPORTED_ERR: Always thrown if the current document does not * support the "XML" feature, since namespaces were * defined by XML. + * @spec https://www.w3.org/TR/1999/REC-xml-names-19990114 Namespaces in XML * @since 1.4, DOM Level 2 */ public Element createElementNS(String namespaceURI, @@ -480,6 +484,7 @@ public Element createElementNS(String namespaceURI, *
    NOT_SUPPORTED_ERR: Always thrown if the current document does not * support the "XML" feature, since namespaces were * defined by XML. + * @spec https://www.w3.org/TR/1999/REC-xml-names-19990114 Namespaces in XML * @since 1.4, DOM Level 2 */ public Attr createAttributeNS(String namespaceURI, @@ -527,6 +532,7 @@ public NodeList getElementsByTagNameNS(String namespaceURI, * An attribute specifying, as part of the XML declaration, the encoding of this document. This is null when * unspecified or when it is not known, such as when the * Document was created in memory. + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) * @since 1.5, DOM Level 3 */ public String getXmlEncoding(); @@ -539,6 +545,7 @@ public NodeList getElementsByTagNameNS(String namespaceURI, * Document.normalizeDocument() with the "validate" * parameter to verify if the value matches the validity * constraint for standalone document declaration as defined in [XML 1.0]. + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) * @since 1.5, DOM Level 3 */ public boolean getXmlStandalone(); @@ -553,6 +560,7 @@ public NodeList getElementsByTagNameNS(String namespaceURI, * @exception DOMException * NOT_SUPPORTED_ERR: Raised if this document does not support the * "XML" feature. + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) * @since 1.5, DOM Level 3 */ public void setXmlStandalone(boolean xmlStandalone) @@ -580,6 +588,8 @@ public void setXmlStandalone(boolean xmlStandalone) * objects supporting a version of the "XMLVersion" feature must not * raise a NOT_SUPPORTED_ERR exception for the same version * number when using Document.xmlVersion. + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) + * @spec https://www.w3.org/TR/2004/REC-xml11-20040204 Extensible Markup Language (XML) 1.1 * @since 1.5, DOM Level 3 */ public String getXmlVersion(); @@ -609,6 +619,8 @@ public void setXmlStandalone(boolean xmlStandalone) * NOT_SUPPORTED_ERR: Raised if the version is set to a value that is * not supported by this Document or if this document * does not support the "XML" feature. + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) + * @spec https://www.w3.org/TR/2004/REC-xml11-20040204 Extensible Markup Language (XML) 1.1 * @since 1.5, DOM Level 3 */ public void setXmlVersion(String xmlVersion) @@ -648,6 +660,7 @@ public void setXmlVersion(String xmlVersion) * "HTML" [DOM Level 2 HTML] * , the href attribute of the HTML BASE element takes precedence over * this attribute when computing Node.baseURI. + * @spec https://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109 Document Object Model (DOM) Level 2 HTML Specification * @since 1.5, DOM Level 3 */ public String getDocumentURI(); @@ -662,6 +675,7 @@ public void setXmlVersion(String xmlVersion) * "HTML" [DOM Level 2 HTML] * , the href attribute of the HTML BASE element takes precedence over * this attribute when computing Node.baseURI. + * @spec https://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109 Document Object Model (DOM) Level 2 HTML Specification * @since 1.5, DOM Level 3 */ public void setDocumentURI(String documentURI); @@ -844,6 +858,7 @@ public Node adoptNode(Node source) * . Also raised, when the node being renamed is an attribute, if the * qualifiedName, or its prefix, is "xmlns" and the * namespaceURI is different from "http://www.w3.org/2000/xmlns/". + * @spec https://www.w3.org/TR/1999/REC-xml-names-19990114 Namespaces in XML * @since 1.5, DOM Level 3 */ public Node renameNode(Node n, diff --git a/src/java.xml/share/classes/org/w3c/dom/DocumentFragment.java b/src/java.xml/share/classes/org/w3c/dom/DocumentFragment.java index 01c35ef289c4a..07c34fef9f1ff 100644 --- a/src/java.xml/share/classes/org/w3c/dom/DocumentFragment.java +++ b/src/java.xml/share/classes/org/w3c/dom/DocumentFragment.java @@ -77,6 +77,7 @@ * interface, such as Node.insertBefore and * Node.appendChild. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification */ public interface DocumentFragment extends Node { } diff --git a/src/java.xml/share/classes/org/w3c/dom/DocumentType.java b/src/java.xml/share/classes/org/w3c/dom/DocumentType.java index b28bea811b624..1d8431741c336 100644 --- a/src/java.xml/share/classes/org/w3c/dom/DocumentType.java +++ b/src/java.xml/share/classes/org/w3c/dom/DocumentType.java @@ -51,6 +51,7 @@ *

    DOM Level 3 doesn't support editing DocumentType nodes. * DocumentType nodes are read-only. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification */ public interface DocumentType extends Node { /** diff --git a/src/java.xml/share/classes/org/w3c/dom/Element.java b/src/java.xml/share/classes/org/w3c/dom/Element.java index ab5087d2c5228..08c04e8f540f1 100644 --- a/src/java.xml/share/classes/org/w3c/dom/Element.java +++ b/src/java.xml/share/classes/org/w3c/dom/Element.java @@ -57,6 +57,7 @@ *

    Note: In DOM Level 2, the method normalize is * inherited from the Node interface where it was moved. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification */ public interface Element extends Node { /** @@ -203,6 +204,8 @@ public Attr removeAttributeNode(Attr oldAttr) * NOT_SUPPORTED_ERR: May be raised if the implementation does not * support the feature "XML" and the language exposed * through the Document does not support XML Namespaces (such as [HTML 4.01]). + * @spec https://www.w3.org/TR/html4 HTML 4.01 Specification + * @spec https://www.w3.org/TR/1999/REC-xml-names-19990114 Namespaces in XML * @since 1.4, DOM Level 2 */ public String getAttributeNS(String namespaceURI, @@ -249,6 +252,8 @@ public String getAttributeNS(String namespaceURI, *
    NOT_SUPPORTED_ERR: May be raised if the implementation does not * support the feature "XML" and the language exposed * through the Document does not support XML Namespaces (such as [HTML 4.01]). + * @spec https://www.w3.org/TR/html4 HTML 4.01 Specification + * @spec https://www.w3.org/TR/1999/REC-xml-names-19990114 Namespaces in XML * @since 1.4, DOM Level 2 */ public void setAttributeNS(String namespaceURI, @@ -278,6 +283,8 @@ public void setAttributeNS(String namespaceURI, *
    NOT_SUPPORTED_ERR: May be raised if the implementation does not * support the feature "XML" and the language exposed * through the Document does not support XML Namespaces (such as [HTML 4.01]). + * @spec https://www.w3.org/TR/html4 HTML 4.01 Specification + * @spec https://www.w3.org/TR/1999/REC-xml-names-19990114 Namespaces in XML * @since 1.4, DOM Level 2 */ public void removeAttributeNS(String namespaceURI, @@ -299,6 +306,8 @@ public void removeAttributeNS(String namespaceURI, * NOT_SUPPORTED_ERR: May be raised if the implementation does not * support the feature "XML" and the language exposed * through the Document does not support XML Namespaces (such as [HTML 4.01]). + * @spec https://www.w3.org/TR/html4 HTML 4.01 Specification + * @spec https://www.w3.org/TR/1999/REC-xml-names-19990114 Namespaces in XML * @since 1.4, DOM Level 2 */ public Attr getAttributeNodeNS(String namespaceURI, @@ -329,6 +338,8 @@ public Attr getAttributeNodeNS(String namespaceURI, *
    NOT_SUPPORTED_ERR: May be raised if the implementation does not * support the feature "XML" and the language exposed * through the Document does not support XML Namespaces (such as [HTML 4.01]). + * @spec https://www.w3.org/TR/html4 HTML 4.01 Specification + * @spec https://www.w3.org/TR/1999/REC-xml-names-19990114 Namespaces in XML * @since 1.4, DOM Level 2 */ public Attr setAttributeNodeNS(Attr newAttr) @@ -348,6 +359,7 @@ public Attr setAttributeNodeNS(Attr newAttr) * NOT_SUPPORTED_ERR: May be raised if the implementation does not * support the feature "XML" and the language exposed * through the Document does not support XML Namespaces (such as [HTML 4.01]). + * @spec https://www.w3.org/TR/html4 HTML 4.01 Specification * @since 1.4, DOM Level 2 */ public NodeList getElementsByTagNameNS(String namespaceURI, @@ -383,6 +395,8 @@ public NodeList getElementsByTagNameNS(String namespaceURI, * NOT_SUPPORTED_ERR: May be raised if the implementation does not * support the feature "XML" and the language exposed * through the Document does not support XML Namespaces (such as [HTML 4.01]). + * @spec https://www.w3.org/TR/html4 HTML 4.01 Specification + * @spec https://www.w3.org/TR/1999/REC-xml-names-19990114 Namespaces in XML * @since 1.4, DOM Level 2 */ public boolean hasAttributeNS(String namespaceURI, diff --git a/src/java.xml/share/classes/org/w3c/dom/ElementTraversal.java b/src/java.xml/share/classes/org/w3c/dom/ElementTraversal.java index f632eb316e8b1..8fe6278348caf 100644 --- a/src/java.xml/share/classes/org/w3c/dom/ElementTraversal.java +++ b/src/java.xml/share/classes/org/w3c/dom/ElementTraversal.java @@ -49,6 +49,7 @@ * fifth method, {@link #getChildElementCount}, exposes the number of child * elements of an element, for preprocessing before navigation. * + * @spec https://www.w3.org/TR/ElementTraversal Element Traversal Specification * @see * Element Traversal Specification * diff --git a/src/java.xml/share/classes/org/w3c/dom/Entity.java b/src/java.xml/share/classes/org/w3c/dom/Entity.java index c4e3b8930c7fe..12e8f6d30cb7f 100644 --- a/src/java.xml/share/classes/org/w3c/dom/Entity.java +++ b/src/java.xml/share/classes/org/w3c/dom/Entity.java @@ -71,6 +71,8 @@ * they are created using the createEntityReference method of * the Document interface. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) */ public interface Entity extends Node { /** diff --git a/src/java.xml/share/classes/org/w3c/dom/EntityReference.java b/src/java.xml/share/classes/org/w3c/dom/EntityReference.java index 65aade6acde54..1ce8e0efe310d 100644 --- a/src/java.xml/share/classes/org/w3c/dom/EntityReference.java +++ b/src/java.xml/share/classes/org/w3c/dom/EntityReference.java @@ -67,6 +67,7 @@ * 1.0 and XML Schema, the normalization is performed after entity reference * are expanded. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification */ public interface EntityReference extends Node { } diff --git a/src/java.xml/share/classes/org/w3c/dom/NameList.java b/src/java.xml/share/classes/org/w3c/dom/NameList.java index 92ee1814087f9..d52fe1f677ef6 100644 --- a/src/java.xml/share/classes/org/w3c/dom/NameList.java +++ b/src/java.xml/share/classes/org/w3c/dom/NameList.java @@ -48,6 +48,7 @@ * implemented. The items in the NameList are accessible via an * integral index, starting from 0. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification * @since 1.5, DOM Level 3 */ public interface NameList { diff --git a/src/java.xml/share/classes/org/w3c/dom/NamedNodeMap.java b/src/java.xml/share/classes/org/w3c/dom/NamedNodeMap.java index c9d3084f15112..11642469abb93 100644 --- a/src/java.xml/share/classes/org/w3c/dom/NamedNodeMap.java +++ b/src/java.xml/share/classes/org/w3c/dom/NamedNodeMap.java @@ -52,6 +52,7 @@ * and does not imply that the DOM specifies an order to these Nodes. *

    NamedNodeMap objects in the DOM are live. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification */ public interface NamedNodeMap { /** @@ -141,6 +142,8 @@ public Node removeNamedItem(String name) * NOT_SUPPORTED_ERR: May be raised if the implementation does not * support the feature "XML" and the language exposed through the * Document does not support XML Namespaces (such as [HTML 4.01]). + * @spec https://www.w3.org/TR/html4 HTML 4.01 Specification + * @spec https://www.w3.org/TR/1999/REC-xml-names-19990114 Namespaces in XML * @since 1.4, DOM Level 2 */ public Node getNamedItemNS(String namespaceURI, @@ -177,6 +180,8 @@ public Node getNamedItemNS(String namespaceURI, *
    NOT_SUPPORTED_ERR: May be raised if the implementation does not * support the feature "XML" and the language exposed through the * Document does not support XML Namespaces (such as [HTML 4.01]). + * @spec https://www.w3.org/TR/html4 HTML 4.01 Specification + * @spec https://www.w3.org/TR/1999/REC-xml-names-19990114 Namespaces in XML * @since 1.4, DOM Level 2 */ public Node setNamedItemNS(Node arg) @@ -203,6 +208,8 @@ public Node setNamedItemNS(Node arg) *
    NOT_SUPPORTED_ERR: May be raised if the implementation does not * support the feature "XML" and the language exposed through the * Document does not support XML Namespaces (such as [HTML 4.01]). + * @spec https://www.w3.org/TR/html4 HTML 4.01 Specification + * @spec https://www.w3.org/TR/1999/REC-xml-names-19990114 Namespaces in XML * @since 1.4, DOM Level 2 */ public Node removeNamedItemNS(String namespaceURI, diff --git a/src/java.xml/share/classes/org/w3c/dom/Node.java b/src/java.xml/share/classes/org/w3c/dom/Node.java index 2ba7fc1256493..04288bc21dd01 100644 --- a/src/java.xml/share/classes/org/w3c/dom/Node.java +++ b/src/java.xml/share/classes/org/w3c/dom/Node.java @@ -166,6 +166,7 @@ * * *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification */ public interface Node { // NodeType @@ -496,6 +497,7 @@ public Node appendChild(Node newChild) * sufficient, since XPointers do not differentiate between * Text nodes and CDATASection nodes. * + * @spec https://www.w3.org/TR/2003/REC-xptr-framework-20030325 XPointer Framework * @since 1.4, DOM Level 3 */ public void normalize(); @@ -528,6 +530,7 @@ public boolean isSupported(String feature, * attached to. If an attribute is not explicitly given a namespace, it * simply has no namespace. * + * @spec https://www.w3.org/TR/1999/REC-xml-names-19990114 Namespaces in XML * @since 1.4, DOM Level 2 */ public String getNamespaceURI(); @@ -589,6 +592,7 @@ public boolean isSupported(String feature, * this node is "xmlns" [XML Namespaces] * . * + * @spec https://www.w3.org/TR/1999/REC-xml-names-19990114 Namespaces in XML * @since 1.4, DOM Level 2 */ public void setPrefix(String prefix) @@ -624,6 +628,7 @@ public void setPrefix(String prefix) * documentURI attribute from the Document * interface otherwise. * + * @spec https://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109 Document Object Model (DOM) Level 2 HTML Specification * @since 1.5, DOM Level 3 */ public String getBaseURI(); diff --git a/src/java.xml/share/classes/org/w3c/dom/NodeList.java b/src/java.xml/share/classes/org/w3c/dom/NodeList.java index 20521f1f3f32a..b2827cb7b5289 100644 --- a/src/java.xml/share/classes/org/w3c/dom/NodeList.java +++ b/src/java.xml/share/classes/org/w3c/dom/NodeList.java @@ -48,6 +48,7 @@ *

    The items in the NodeList are accessible via an integral * index, starting from 0. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification */ public interface NodeList { /** diff --git a/src/java.xml/share/classes/org/w3c/dom/Notation.java b/src/java.xml/share/classes/org/w3c/dom/Notation.java index 3b5db96e11838..e081e4f5dcbaa 100644 --- a/src/java.xml/share/classes/org/w3c/dom/Notation.java +++ b/src/java.xml/share/classes/org/w3c/dom/Notation.java @@ -51,6 +51,8 @@ * are therefore readonly. *

    A Notation node does not have any parent. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) */ public interface Notation extends Node { /** diff --git a/src/java.xml/share/classes/org/w3c/dom/ProcessingInstruction.java b/src/java.xml/share/classes/org/w3c/dom/ProcessingInstruction.java index a8ee739d38805..dce6cc82a0647 100644 --- a/src/java.xml/share/classes/org/w3c/dom/ProcessingInstruction.java +++ b/src/java.xml/share/classes/org/w3c/dom/ProcessingInstruction.java @@ -52,6 +52,8 @@ * presence of this character sequence must generate a fatal error during * serialization. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) */ public interface ProcessingInstruction extends Node { /** diff --git a/src/java.xml/share/classes/org/w3c/dom/Text.java b/src/java.xml/share/classes/org/w3c/dom/Text.java index c603dac3eadb6..02f25356220e5 100644 --- a/src/java.xml/share/classes/org/w3c/dom/Text.java +++ b/src/java.xml/share/classes/org/w3c/dom/Text.java @@ -65,6 +65,8 @@ * the quotation mark character " or the apostrophe character ' when part of * an attribute. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) */ public interface Text extends CharacterData { /** @@ -93,6 +95,7 @@ public Text splitText(int offset) * determined to contain whitespace in element content during the load * of the document or if validation occurs while using * Document.normalizeDocument(). + * @spec https://www.w3.org/TR/2004/REC-xml-infoset-20040204 XML Information Set (Second Edition) * @since 1.5, DOM Level 3 */ public boolean isElementContentWhitespace(); diff --git a/src/java.xml/share/classes/org/w3c/dom/TypeInfo.java b/src/java.xml/share/classes/org/w3c/dom/TypeInfo.java index a67f1c3e8dcc6..11518193b187b 100644 --- a/src/java.xml/share/classes/org/w3c/dom/TypeInfo.java +++ b/src/java.xml/share/classes/org/w3c/dom/TypeInfo.java @@ -118,6 +118,10 @@ * and therefore should define how to represent their type systems using * TypeInfo. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) + * @spec https://www.w3.org/TR/2004/REC-xml-infoset-20040204 XML Information Set (Second Edition) + * @spec https://www.w3.org/TR/2001/REC-xmlschema-1-20010502 XML Schema Part 1: Structures * @since 1.5, DOM Level 3 */ public interface TypeInfo { @@ -145,6 +149,7 @@ public interface TypeInfo { * reference type definition, or if the other type definition can be * reached recursively following the {base type definition} property * from the reference type definition, and all the derivation methods involved are restriction. + * @spec https://www.w3.org/TR/2001/REC-xmlschema-1-20010502 XML Schema Part 1: Structures */ public static final int DERIVATION_RESTRICTION = 0x00000001; /** @@ -155,6 +160,7 @@ public interface TypeInfo { * other type definition if the other type definition can be reached * recursively following the {base type definition} property from the * reference type definition, and at least one of the derivation methods involved is an extension. + * @spec https://www.w3.org/TR/2001/REC-xmlschema-1-20010502 XML Schema Part 1: Structures */ public static final int DERIVATION_EXTENSION = 0x00000002; /** @@ -169,6 +175,7 @@ public interface TypeInfo { * definition by DERIVATION_RESTRICTION, T1 has {variety} union, and one of the {member type definitions} is T2. Note that T1 could be * the same as the reference type definition, and T2 could be the same * as the other type definition. + * @spec https://www.w3.org/TR/2001/REC-xmlschema-1-20010502 XML Schema Part 1: Structures */ public static final int DERIVATION_UNION = 0x00000004; /** @@ -182,6 +189,7 @@ public interface TypeInfo { * definition by DERIVATION_RESTRICTION, T1 has {variety} list, and T2 is the {item type definition}. Note that T1 could be the same as * the reference type definition, and T2 could be the same as the other * type definition. + * @spec https://www.w3.org/TR/2001/REC-xmlschema-1-20010502 XML Schema Part 1: Structures */ public static final int DERIVATION_LIST = 0x00000008; diff --git a/src/java.xml/share/classes/org/w3c/dom/UserDataHandler.java b/src/java.xml/share/classes/org/w3c/dom/UserDataHandler.java index e6595abfc1f06..ae7e38de4a60b 100644 --- a/src/java.xml/share/classes/org/w3c/dom/UserDataHandler.java +++ b/src/java.xml/share/classes/org/w3c/dom/UserDataHandler.java @@ -49,6 +49,7 @@ * implement various behaviors regarding the data it associates to the DOM * nodes. This interface defines that handler. *

    See also the Document Object Model (DOM) Level 3 Core Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification * @since 1.5, DOM Level 3 */ public interface UserDataHandler { diff --git a/src/java.xml/share/classes/org/w3c/dom/events/DocumentEvent.java b/src/java.xml/share/classes/org/w3c/dom/events/DocumentEvent.java index 2a5f62f10fd04..3bbad8543a670 100644 --- a/src/java.xml/share/classes/org/w3c/dom/events/DocumentEvent.java +++ b/src/java.xml/share/classes/org/w3c/dom/events/DocumentEvent.java @@ -50,6 +50,7 @@ * implemented on the same object which implements the Document * interface in an implementation which supports the Event model. *

    See also the Document Object Model (DOM) Level 2 Events Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113 Document Object Model (DOM) Level 2 Events Specification * @since 1.5, DOM Level 2 */ public interface DocumentEvent { diff --git a/src/java.xml/share/classes/org/w3c/dom/events/Event.java b/src/java.xml/share/classes/org/w3c/dom/events/Event.java index efa68650104f7..cf104caef80b2 100644 --- a/src/java.xml/share/classes/org/w3c/dom/events/Event.java +++ b/src/java.xml/share/classes/org/w3c/dom/events/Event.java @@ -51,6 +51,7 @@ * type of event they accompany. These derived interfaces are also * implemented by the object passed to the event listener. *

    See also the Document Object Model (DOM) Level 2 Events Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113 Document Object Model (DOM) Level 2 Events Specification * @since 1.5, DOM Level 2 */ public interface Event { diff --git a/src/java.xml/share/classes/org/w3c/dom/events/EventException.java b/src/java.xml/share/classes/org/w3c/dom/events/EventException.java index 53bb348075468..e9c25daa54953 100644 --- a/src/java.xml/share/classes/org/w3c/dom/events/EventException.java +++ b/src/java.xml/share/classes/org/w3c/dom/events/EventException.java @@ -45,6 +45,7 @@ * Event operations may throw an EventException as specified in * their method descriptions. *

    See also the Document Object Model (DOM) Level 2 Events Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113 Document Object Model (DOM) Level 2 Events Specification * @since 1.5, DOM Level 2 */ public class EventException extends RuntimeException { diff --git a/src/java.xml/share/classes/org/w3c/dom/events/EventListener.java b/src/java.xml/share/classes/org/w3c/dom/events/EventListener.java index a11dec1ef86ea..49fb2efc81c0e 100644 --- a/src/java.xml/share/classes/org/w3c/dom/events/EventListener.java +++ b/src/java.xml/share/classes/org/w3c/dom/events/EventListener.java @@ -54,6 +54,7 @@ * the user wishes the same EventListeners to be added to the * newly created copy the user must add them manually. *

    See also the Document Object Model (DOM) Level 2 Events Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113 Document Object Model (DOM) Level 2 Events Specification * @since 1.5, DOM Level 2 */ public interface EventListener { diff --git a/src/java.xml/share/classes/org/w3c/dom/events/EventTarget.java b/src/java.xml/share/classes/org/w3c/dom/events/EventTarget.java index 3fd5aefa458f9..eb88fd0067f02 100644 --- a/src/java.xml/share/classes/org/w3c/dom/events/EventTarget.java +++ b/src/java.xml/share/classes/org/w3c/dom/events/EventTarget.java @@ -50,6 +50,7 @@ * EventListeners on an EventTarget and dispatch * of events to that EventTarget. *

    See also the Document Object Model (DOM) Level 2 Events Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113 Document Object Model (DOM) Level 2 Events Specification * @since 1.5, DOM Level 2 */ public interface EventTarget { diff --git a/src/java.xml/share/classes/org/w3c/dom/events/MouseEvent.java b/src/java.xml/share/classes/org/w3c/dom/events/MouseEvent.java index 7a21af99b05de..222806e82e0b9 100644 --- a/src/java.xml/share/classes/org/w3c/dom/events/MouseEvent.java +++ b/src/java.xml/share/classes/org/w3c/dom/events/MouseEvent.java @@ -58,6 +58,7 @@ * bubbling to obtain notification of mouse events which occur within its * descendent elements. *

    See also the Document Object Model (DOM) Level 2 Events Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113 Document Object Model (DOM) Level 2 Events Specification * @since 1.5, DOM Level 2 */ public interface MouseEvent extends UIEvent { diff --git a/src/java.xml/share/classes/org/w3c/dom/events/MutationEvent.java b/src/java.xml/share/classes/org/w3c/dom/events/MutationEvent.java index 1dc5c81599119..6c5bfe3434522 100644 --- a/src/java.xml/share/classes/org/w3c/dom/events/MutationEvent.java +++ b/src/java.xml/share/classes/org/w3c/dom/events/MutationEvent.java @@ -47,6 +47,7 @@ * The MutationEvent interface provides specific contextual * information associated with Mutation events. *

    See also the Document Object Model (DOM) Level 2 Events Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113 Document Object Model (DOM) Level 2 Events Specification * @since 1.5, DOM Level 2 */ public interface MutationEvent extends Event { diff --git a/src/java.xml/share/classes/org/w3c/dom/events/UIEvent.java b/src/java.xml/share/classes/org/w3c/dom/events/UIEvent.java index 01192194cede9..b973fffcaebd3 100644 --- a/src/java.xml/share/classes/org/w3c/dom/events/UIEvent.java +++ b/src/java.xml/share/classes/org/w3c/dom/events/UIEvent.java @@ -47,6 +47,7 @@ * The UIEvent interface provides specific contextual information * associated with User Interface events. *

    See also the Document Object Model (DOM) Level 2 Events Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113 Document Object Model (DOM) Level 2 Events Specification * @since 1.5, DOM Level 2 */ public interface UIEvent extends Event { diff --git a/src/java.xml/share/classes/org/w3c/dom/events/package-info.java b/src/java.xml/share/classes/org/w3c/dom/events/package-info.java index 2792c7c3d3e4f..c81cd5a48d8fb 100644 --- a/src/java.xml/share/classes/org/w3c/dom/events/package-info.java +++ b/src/java.xml/share/classes/org/w3c/dom/events/package-info.java @@ -36,6 +36,8 @@ * that gives to programs and scripts a generic event system. * * + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113 Document Object Model (DOM) Level 2 Events Specification + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Views-20001113 Document Object Model (DOM) Level 2 Views Specification * @since 1.5 */ diff --git a/src/java.xml/share/classes/org/w3c/dom/ls/DOMImplementationLS.java b/src/java.xml/share/classes/org/w3c/dom/ls/DOMImplementationLS.java index 986db03f7d015..3d96996630cc5 100644 --- a/src/java.xml/share/classes/org/w3c/dom/ls/DOMImplementationLS.java +++ b/src/java.xml/share/classes/org/w3c/dom/ls/DOMImplementationLS.java @@ -59,6 +59,8 @@ *

    See also the Document Object Model (DOM) Level 3 Load and Save Specification. * + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification + * @spec https://www.w3.org/TR/DOM-Level-3-LS Document Object Model (DOM) Level 3 Load and Save Specification * @since 1.5 */ public interface DOMImplementationLS { @@ -114,6 +116,9 @@ public interface DOMImplementationLS { * @exception DOMException * NOT_SUPPORTED_ERR: Raised if the requested mode or schema type is * not supported. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) + * @spec https://www.w3.org/TR/2001/REC-xmlschema-1-20010502 XML Schema Part 1: Structures */ public LSParser createLSParser(short mode, String schemaType) diff --git a/src/java.xml/share/classes/org/w3c/dom/ls/LSException.java b/src/java.xml/share/classes/org/w3c/dom/ls/LSException.java index 61ec756ed9194..7bfbd19d4d1a0 100644 --- a/src/java.xml/share/classes/org/w3c/dom/ls/LSException.java +++ b/src/java.xml/share/classes/org/w3c/dom/ls/LSException.java @@ -55,6 +55,7 @@ *

    See also the Document Object Model (DOM) Level 3 Load and Save Specification. * + * @spec https://www.w3.org/TR/DOM-Level-3-LS Document Object Model (DOM) Level 3 Load and Save Specification * @since 1.5 */ public class LSException extends RuntimeException { diff --git a/src/java.xml/share/classes/org/w3c/dom/ls/LSInput.java b/src/java.xml/share/classes/org/w3c/dom/ls/LSInput.java index f6f69b986cb47..0700017c7a222 100644 --- a/src/java.xml/share/classes/org/w3c/dom/ls/LSInput.java +++ b/src/java.xml/share/classes/org/w3c/dom/ls/LSInput.java @@ -83,6 +83,7 @@ *

    See also the Document Object Model (DOM) Level 3 Load and Save Specification. * + * @spec https://www.w3.org/TR/DOM-Level-3-LS Document Object Model (DOM) Level 3 Load and Save Specification * @since 1.5 */ public interface LSInput { @@ -156,6 +157,7 @@ public interface LSInput { * implementation will attempt to resolve the relative URI with the * baseURI as the base, if that fails, the behavior is * implementation dependent. + * @spec https://www.rfc-editor.org/info/rfc2396 RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax */ public String getSystemId(); /** @@ -175,6 +177,7 @@ public interface LSInput { * implementation will attempt to resolve the relative URI with the * baseURI as the base, if that fails, the behavior is * implementation dependent. + * @spec https://www.rfc-editor.org/info/rfc2396 RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax */ public void setSystemId(String systemId); @@ -200,6 +203,7 @@ public interface LSInput { * resolving a relative systemId to an absolute URI. *
    If, when used, the base URI is itself a relative URI, an empty * string, or null, the behavior is implementation dependent. + * @spec https://www.rfc-editor.org/info/rfc2396 RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax */ public String getBaseURI(); /** @@ -207,6 +211,7 @@ public interface LSInput { * resolving a relative systemId to an absolute URI. *
    If, when used, the base URI is itself a relative URI, an empty * string, or null, the behavior is implementation dependent. + * @spec https://www.rfc-editor.org/info/rfc2396 RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax */ public void setBaseURI(String baseURI); @@ -219,6 +224,8 @@ public interface LSInput { * encoding specified by means of this attribute will override any * encoding specified in the XML declaration or the Text declaration, or * an encoding obtained from a higher level protocol, such as HTTP [IETF RFC 2616]. + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) + * @spec https://www.rfc-editor.org/info/rfc2616 RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1 */ public String getEncoding(); /** @@ -230,6 +237,8 @@ public interface LSInput { * encoding specified by means of this attribute will override any * encoding specified in the XML declaration or the Text declaration, or * an encoding obtained from a higher level protocol, such as HTTP [IETF RFC 2616]. + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) + * @spec https://www.rfc-editor.org/info/rfc2616 RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1 */ public void setEncoding(String encoding); @@ -237,12 +246,14 @@ public interface LSInput { * If set to true, assume that the input is certified (see section 2.13 * in [XML 1.1]) when * parsing [XML 1.1]. + * @spec https://www.w3.org/TR/2004/REC-xml11-20040204 Extensible Markup Language (XML) 1.1 */ public boolean getCertifiedText(); /** * If set to true, assume that the input is certified (see section 2.13 * in [XML 1.1]) when * parsing [XML 1.1]. + * @spec https://www.w3.org/TR/2004/REC-xml11-20040204 Extensible Markup Language (XML) 1.1 */ public void setCertifiedText(boolean certifiedText); diff --git a/src/java.xml/share/classes/org/w3c/dom/ls/LSLoadEvent.java b/src/java.xml/share/classes/org/w3c/dom/ls/LSLoadEvent.java index a4f938d0c8956..5d345358e2417 100644 --- a/src/java.xml/share/classes/org/w3c/dom/ls/LSLoadEvent.java +++ b/src/java.xml/share/classes/org/w3c/dom/ls/LSLoadEvent.java @@ -50,6 +50,7 @@ *

    See also the Document Object Model (DOM) Level 3 Load and Save Specification. * + * @spec https://www.w3.org/TR/DOM-Level-3-LS Document Object Model (DOM) Level 3 Load and Save Specification * @since 1.5 */ public interface LSLoadEvent extends Event { diff --git a/src/java.xml/share/classes/org/w3c/dom/ls/LSOutput.java b/src/java.xml/share/classes/org/w3c/dom/ls/LSOutput.java index f458f540e53dc..9423ab0d50860 100644 --- a/src/java.xml/share/classes/org/w3c/dom/ls/LSOutput.java +++ b/src/java.xml/share/classes/org/w3c/dom/ls/LSOutput.java @@ -75,6 +75,7 @@ *

    See also the Document Object Model (DOM) Level 3 Load and Save Specification. * + * @spec https://www.w3.org/TR/DOM-Level-3-LS Document Object Model (DOM) Level 3 Load and Save Specification * @since 1.5 */ public interface LSOutput { @@ -105,6 +106,7 @@ public interface LSOutput { * output destination. *
    If the system ID is a relative URI reference (see section 5 in [IETF RFC 2396]), the * behavior is implementation dependent. + * @spec https://www.rfc-editor.org/info/rfc2396 RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax */ public String getSystemId(); /** @@ -112,6 +114,7 @@ public interface LSOutput { * output destination. *
    If the system ID is a relative URI reference (see section 5 in [IETF RFC 2396]), the * behavior is implementation dependent. + * @spec https://www.rfc-editor.org/info/rfc2396 RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax */ public void setSystemId(String systemId); @@ -122,6 +125,7 @@ public interface LSOutput { * character encodings registered (as charsets) with the Internet * Assigned Numbers Authority [IANA-CHARSETS] * should be referred to using their registered names. + * @spec https://www.w3.org/TR/xml Extensible Markup Language (XML) 1.0 (Fifth Edition) */ public String getEncoding(); /** @@ -131,6 +135,7 @@ public interface LSOutput { * character encodings registered (as charsets) with the Internet * Assigned Numbers Authority [IANA-CHARSETS] * should be referred to using their registered names. + * @spec https://www.w3.org/TR/xml Extensible Markup Language (XML) 1.0 (Fifth Edition) */ public void setEncoding(String encoding); diff --git a/src/java.xml/share/classes/org/w3c/dom/ls/LSParser.java b/src/java.xml/share/classes/org/w3c/dom/ls/LSParser.java index 5b5aa27dea118..05500ad5cbe88 100644 --- a/src/java.xml/share/classes/org/w3c/dom/ls/LSParser.java +++ b/src/java.xml/share/classes/org/w3c/dom/ls/LSParser.java @@ -172,6 +172,10 @@ *

    See also the * Document Object Model (DOM) Level 3 Load and Save Specification. * + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification + * @spec https://www.w3.org/TR/DOM-Level-3-LS Document Object Model (DOM) Level 3 Load and Save Specification + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) + * @spec https://www.w3.org/TR/2004/REC-xml-infoset-20040204 XML Information Set (Second Edition) * @since 1.5 */ public interface LSParser { @@ -298,6 +302,13 @@ public interface LSParser { * Unlike in [DOM Level 3 Core] * , this parameter cannot be set to false. * + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) + * @spec https://www.w3.org/TR/2004/REC-xml11-20040204 Extensible Markup Language (XML) 1.1 + * @spec https://www.w3.org/TR/1999/REC-xml-names-19990114 Namespaces in XML + * @spec https://www.w3.org/TR/2004/REC-xml-names11-20040204 Namespaces in XML 1.1 + * @spec https://www.rfc-editor.org/info/rfc2616 RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1 + * @spec https://www.rfc-editor.org/info/rfc3023 RFC 3023: XML Media Types */ public DOMConfiguration getDomConfig(); @@ -311,6 +322,7 @@ public interface LSParser { * example, if "validate" * is set to true, the validation is done before invoking the * filter. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification */ public LSParserFilter getFilter(); /** @@ -323,6 +335,7 @@ public interface LSParser { * example, if "validate" * is set to true, the validation is done before invoking the * filter. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification */ public void setFilter(LSParserFilter filter); @@ -357,6 +370,7 @@ public interface LSParser { * DOMErrorHandler using the parameter * "error-handler" * if they wish to get details on the error. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification */ public Document parse(LSInput input) throws DOMException, LSException; @@ -384,6 +398,8 @@ public Document parse(LSInput input) * DOMErrorHandler using the parameter * "error-handler" * if they wish to get details on the error. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification + * @spec https://www.rfc-editor.org/info/rfc2396 RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax */ public Document parseURI(String uri) throws DOMException, LSException; @@ -504,6 +520,7 @@ public Document parseURI(String uri) * DOMErrorHandler using the parameter * "error-handler" * if they wish to get details on the error. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification */ public Node parseWithContext(LSInput input, Node contextArg, diff --git a/src/java.xml/share/classes/org/w3c/dom/ls/LSParserFilter.java b/src/java.xml/share/classes/org/w3c/dom/ls/LSParserFilter.java index e592841f476f3..3e302042887d9 100644 --- a/src/java.xml/share/classes/org/w3c/dom/ls/LSParserFilter.java +++ b/src/java.xml/share/classes/org/w3c/dom/ls/LSParserFilter.java @@ -75,6 +75,8 @@ *

    See also the Document Object Model (DOM) Level 3 Load and Save Specification. * + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification + * @spec https://www.w3.org/TR/DOM-Level-3-LS Document Object Model (DOM) Level 3 Load and Save Specification * @since 1.5 */ public interface LSParserFilter { @@ -198,6 +200,7 @@ public interface LSParserFilter { * will never be passed to LSParserFilter.acceptNode. *
    The constants used here are defined in * [DOM Level 2 Traversal and Range]. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113 Document Object Model (DOM) Level 2 Traversal and Range Specification */ public int getWhatToShow(); diff --git a/src/java.xml/share/classes/org/w3c/dom/ls/LSProgressEvent.java b/src/java.xml/share/classes/org/w3c/dom/ls/LSProgressEvent.java index 6e1b5653ef7dc..ef7fc40bd3dbd 100644 --- a/src/java.xml/share/classes/org/w3c/dom/ls/LSProgressEvent.java +++ b/src/java.xml/share/classes/org/w3c/dom/ls/LSProgressEvent.java @@ -54,6 +54,8 @@ *

    See also the Document Object Model (DOM) Level 3 Load and Save Specification. * + * @spec https://www.w3.org/TR/2003/NOTE-DOM-Level-3-Events-20031107 Document Object Model (DOM) Level 3 Events Specification + * @spec https://www.w3.org/TR/DOM-Level-3-LS Document Object Model (DOM) Level 3 Load and Save Specification * @since 1.5 */ public interface LSProgressEvent extends Event { diff --git a/src/java.xml/share/classes/org/w3c/dom/ls/LSResourceResolver.java b/src/java.xml/share/classes/org/w3c/dom/ls/LSResourceResolver.java index 2361c2dd5eb4f..4732a588a85ad 100644 --- a/src/java.xml/share/classes/org/w3c/dom/ls/LSResourceResolver.java +++ b/src/java.xml/share/classes/org/w3c/dom/ls/LSResourceResolver.java @@ -64,6 +64,7 @@ *

    See also the Document Object Model (DOM) Level 3 Load and Save Specification. * + * @spec https://www.w3.org/TR/DOM-Level-3-LS Document Object Model (DOM) Level 3 Load and Save Specification * @since 1.5 */ public interface LSResourceResolver { @@ -102,6 +103,9 @@ public interface LSResourceResolver { * @return A LSInput object describing the new input * source, or null to request that the parser open a * regular URI connection to the resource. + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) + * @spec https://www.rfc-editor.org/info/rfc2396 RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax + * @spec https://www.w3.org/TR/2001/REC-xmlschema-1-20010502 XML Schema Part 1: Structures */ public LSInput resolveResource(String type, String namespaceURI, diff --git a/src/java.xml/share/classes/org/w3c/dom/ls/LSSerializer.java b/src/java.xml/share/classes/org/w3c/dom/ls/LSSerializer.java index 2d34d29f63477..558cad6067112 100644 --- a/src/java.xml/share/classes/org/w3c/dom/ls/LSSerializer.java +++ b/src/java.xml/share/classes/org/w3c/dom/ls/LSSerializer.java @@ -216,6 +216,10 @@ * Document Object Model (DOM) Level 3 Load and Save Specification. * + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113 Document Object Model (DOM) Level 2 Core Specification + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification + * @spec https://www.w3.org/TR/DOM-Level-3-LS Document Object Model (DOM) Level 3 Load and Save Specification + * @spec https://www.w3.org/TR/2004/REC-xml11-20040204 Extensible Markup Language (XML) 1.1 * @since 1.5 */ public interface LSSerializer { @@ -327,6 +331,10 @@ public interface LSSerializer { * encoding would be needed to be able to re-parse the serialized data). * * + * @spec https://www.w3.org/TR/2001/REC-xml-c14n-20010315 Canonical XML + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) + * @spec https://www.w3.org/TR/2004/REC-xml11-20040204 Extensible Markup Language (XML) 1.1 */ public DOMConfiguration getDomConfig(); @@ -349,6 +357,8 @@ public interface LSSerializer { * content. Setting this attribute to null will reset its * value to the default value. *
    + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) + * @spec https://www.w3.org/TR/2004/REC-xml11-20040204 Extensible Markup Language (XML) 1.1 */ public String getNewLine(); /** @@ -370,6 +380,8 @@ public interface LSSerializer { * content. Setting this attribute to null will reset its * value to the default value. *
    + * @spec https://www.w3.org/TR/2004/REC-xml-20040204 Extensible Markup Language (XML) 1.0 (Third Edition) + * @spec https://www.w3.org/TR/2004/REC-xml11-20040204 Extensible Markup Language (XML) 1.1 */ public void setNewLine(String newLine); @@ -383,6 +395,7 @@ public interface LSSerializer { * example, CDATA sections won't be passed to the filter if * "cdata-sections" * is set to false. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification */ public LSSerializerFilter getFilter(); /** @@ -395,6 +408,7 @@ public interface LSSerializer { * example, CDATA sections won't be passed to the filter if * "cdata-sections" * is set to false. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification */ public void setFilter(LSSerializerFilter filter); @@ -439,6 +453,7 @@ public interface LSSerializer { * DOMErrorHandler using the parameter * "error-handler" * if they wish to get details on the error. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification */ public boolean write(Node nodeArg, LSOutput destination) @@ -462,6 +477,7 @@ public boolean write(Node nodeArg, * DOMErrorHandler using the parameter * "error-handler" * if they wish to get details on the error. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification */ public boolean writeToURI(Node nodeArg, String uri) @@ -485,6 +501,7 @@ public boolean writeToURI(Node nodeArg, * DOMErrorHandler using the parameter * "error-handler" * if they wish to get details on the error. + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification */ public String writeToString(Node nodeArg) throws DOMException, LSException; diff --git a/src/java.xml/share/classes/org/w3c/dom/ls/LSSerializerFilter.java b/src/java.xml/share/classes/org/w3c/dom/ls/LSSerializerFilter.java index 1263473c7532b..afea41267e9c5 100644 --- a/src/java.xml/share/classes/org/w3c/dom/ls/LSSerializerFilter.java +++ b/src/java.xml/share/classes/org/w3c/dom/ls/LSSerializerFilter.java @@ -71,6 +71,8 @@ *

    See also the Document Object Model (DOM) Level 3 Load and Save Specification. * + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113 Document Object Model (DOM) Level 2 Traversal and Range Specification + * @spec https://www.w3.org/TR/DOM-Level-3-LS Document Object Model (DOM) Level 3 Load and Save Specification * @since 1.5 */ public interface LSSerializerFilter extends NodeFilter { @@ -88,6 +90,7 @@ public interface LSSerializerFilter extends NodeFilter { * Attr nodes are shown and passed to the filter. *
    The constants used here are defined in [DOM Level 2 Traversal and Range] * . + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113 Document Object Model (DOM) Level 2 Traversal and Range Specification */ public int getWhatToShow(); diff --git a/src/java.xml/share/classes/org/w3c/dom/ls/package-info.java b/src/java.xml/share/classes/org/w3c/dom/ls/package-info.java index b1369d3ccc8eb..34b31c8c6a0e7 100644 --- a/src/java.xml/share/classes/org/w3c/dom/ls/package-info.java +++ b/src/java.xml/share/classes/org/w3c/dom/ls/package-info.java @@ -33,6 +33,7 @@ * document into an XML document. * * + * @spec https://www.w3.org/TR/DOM-Level-3-LS Document Object Model (DOM) Level 3 Load and Save Specification * @since 1.5 */ diff --git a/src/java.xml/share/classes/org/w3c/dom/package-info.java b/src/java.xml/share/classes/org/w3c/dom/package-info.java index 10f081415ede3..581e694179966 100644 --- a/src/java.xml/share/classes/org/w3c/dom/package-info.java +++ b/src/java.xml/share/classes/org/w3c/dom/package-info.java @@ -31,6 +31,8 @@ * and * Document Object Model (DOM) Level 3 Load and Save Specification. * + * @spec https://www.w3.org/TR/DOM-Level-3-Core Document Object Model (DOM) Level 3 Core Specification + * @spec https://www.w3.org/TR/DOM-Level-3-LS Document Object Model (DOM) Level 3 Load and Save Specification * @apiNote * The documentation comments for the get and set methods within this API are * written as property definitions and are shared between both methods. These diff --git a/src/java.xml/share/classes/org/w3c/dom/ranges/DocumentRange.java b/src/java.xml/share/classes/org/w3c/dom/ranges/DocumentRange.java index 63d5a00bf1a19..ffcfec014ec16 100644 --- a/src/java.xml/share/classes/org/w3c/dom/ranges/DocumentRange.java +++ b/src/java.xml/share/classes/org/w3c/dom/ranges/DocumentRange.java @@ -43,6 +43,7 @@ /** *

    See also the Document Object Model (DOM) Level 2 Traversal and Range Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113 Document Object Model (DOM) Level 2 Traversal and Range Specification * @since 9, DOM Level 2 */ public interface DocumentRange { diff --git a/src/java.xml/share/classes/org/w3c/dom/ranges/Range.java b/src/java.xml/share/classes/org/w3c/dom/ranges/Range.java index 480c9540d872d..c1d679b3157c3 100644 --- a/src/java.xml/share/classes/org/w3c/dom/ranges/Range.java +++ b/src/java.xml/share/classes/org/w3c/dom/ranges/Range.java @@ -47,6 +47,7 @@ /** *

    See also the Document Object Model (DOM) Level 2 Traversal and Range Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113 Document Object Model (DOM) Level 2 Traversal and Range Specification * @since 9, DOM Level 2 */ public interface Range { diff --git a/src/java.xml/share/classes/org/w3c/dom/ranges/RangeException.java b/src/java.xml/share/classes/org/w3c/dom/ranges/RangeException.java index 46a4eb5d9b641..5c1748a477e6d 100644 --- a/src/java.xml/share/classes/org/w3c/dom/ranges/RangeException.java +++ b/src/java.xml/share/classes/org/w3c/dom/ranges/RangeException.java @@ -45,6 +45,7 @@ * Range operations may throw a RangeException as specified in * their method descriptions. *

    See also the Document Object Model (DOM) Level 2 Traversal and Range Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113 Document Object Model (DOM) Level 2 Traversal and Range Specification * @since 9, DOM Level 2 */ public class RangeException extends RuntimeException { diff --git a/src/java.xml/share/classes/org/w3c/dom/ranges/package-info.java b/src/java.xml/share/classes/org/w3c/dom/ranges/package-info.java index ff5d00dfe7c35..6b2de20bd9d58 100644 --- a/src/java.xml/share/classes/org/w3c/dom/ranges/package-info.java +++ b/src/java.xml/share/classes/org/w3c/dom/ranges/package-info.java @@ -31,6 +31,7 @@ * and manipulating a range in a document. * * + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113 Document Object Model (DOM) Level 2 Traversal and Range Specification * @since 1.5 */ diff --git a/src/java.xml/share/classes/org/w3c/dom/traversal/DocumentTraversal.java b/src/java.xml/share/classes/org/w3c/dom/traversal/DocumentTraversal.java index 77392584237ca..c67c2ef7fc06b 100644 --- a/src/java.xml/share/classes/org/w3c/dom/traversal/DocumentTraversal.java +++ b/src/java.xml/share/classes/org/w3c/dom/traversal/DocumentTraversal.java @@ -53,6 +53,7 @@ * Traversal feature, DocumentTraversal will be implemented by * the same objects that implement the Document interface. *

    See also the Document Object Model (DOM) Level 2 Traversal and Range Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113 Document Object Model (DOM) Level 2 Traversal and Range Specification * @since 9, DOM Level 2 */ public interface DocumentTraversal { diff --git a/src/java.xml/share/classes/org/w3c/dom/traversal/NodeFilter.java b/src/java.xml/share/classes/org/w3c/dom/traversal/NodeFilter.java index eefb88e717237..e81249f33ed9e 100644 --- a/src/java.xml/share/classes/org/w3c/dom/traversal/NodeFilter.java +++ b/src/java.xml/share/classes/org/w3c/dom/traversal/NodeFilter.java @@ -59,6 +59,7 @@ * filter may be used with a number of different kinds of traversals, * encouraging code reuse. *

    See also the Document Object Model (DOM) Level 2 Traversal and Range Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113 Document Object Model (DOM) Level 2 Traversal and Range Specification * @since 9, DOM Level 2 */ public interface NodeFilter { diff --git a/src/java.xml/share/classes/org/w3c/dom/traversal/NodeIterator.java b/src/java.xml/share/classes/org/w3c/dom/traversal/NodeIterator.java index 56ebde333f7cd..656970de11363 100644 --- a/src/java.xml/share/classes/org/w3c/dom/traversal/NodeIterator.java +++ b/src/java.xml/share/classes/org/w3c/dom/traversal/NodeIterator.java @@ -55,6 +55,7 @@ * NodeIterators are created by calling * DocumentTraversal.createNodeIterator(). *

    See also the Document Object Model (DOM) Level 2 Traversal and Range Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113 Document Object Model (DOM) Level 2 Traversal and Range Specification * @since 9, DOM Level 2 */ public interface NodeIterator { diff --git a/src/java.xml/share/classes/org/w3c/dom/traversal/TreeWalker.java b/src/java.xml/share/classes/org/w3c/dom/traversal/TreeWalker.java index 59a8c385c7c41..5e04de601fd1d 100644 --- a/src/java.xml/share/classes/org/w3c/dom/traversal/TreeWalker.java +++ b/src/java.xml/share/classes/org/w3c/dom/traversal/TreeWalker.java @@ -60,6 +60,7 @@ * nodes will be siblings and appear as direct children of the root node, no * matter how deeply nested the structure of the original document. *

    See also the Document Object Model (DOM) Level 2 Traversal and Range Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113 Document Object Model (DOM) Level 2 Traversal and Range Specification * @since 9, DOM Level 2 */ public interface TreeWalker { diff --git a/src/java.xml/share/classes/org/w3c/dom/traversal/package-info.java b/src/java.xml/share/classes/org/w3c/dom/traversal/package-info.java index c532be864e705..b00bf05dbbb45 100644 --- a/src/java.xml/share/classes/org/w3c/dom/traversal/package-info.java +++ b/src/java.xml/share/classes/org/w3c/dom/traversal/package-info.java @@ -30,6 +30,7 @@ * the Traversal module contains specialized interfaces dedicated to * traversing the document structure. * + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113 Document Object Model (DOM) Level 2 Traversal and Range Specification * @since 1.5 */ diff --git a/src/java.xml/share/classes/org/w3c/dom/views/AbstractView.java b/src/java.xml/share/classes/org/w3c/dom/views/AbstractView.java index 4f23df62974b3..b19ac43b2dbf3 100644 --- a/src/java.xml/share/classes/org/w3c/dom/views/AbstractView.java +++ b/src/java.xml/share/classes/org/w3c/dom/views/AbstractView.java @@ -44,6 +44,7 @@ /** * A base interface that all views shall derive from. *

    See also the Document Object Model (DOM) Level 2 Views Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Views-20001113 Document Object Model (DOM) Level 2 Views Specification * @since 1.8, DOM Level 2 */ public interface AbstractView { diff --git a/src/java.xml/share/classes/org/w3c/dom/views/DocumentView.java b/src/java.xml/share/classes/org/w3c/dom/views/DocumentView.java index 8716d797079e2..337b3adc398a1 100644 --- a/src/java.xml/share/classes/org/w3c/dom/views/DocumentView.java +++ b/src/java.xml/share/classes/org/w3c/dom/views/DocumentView.java @@ -47,6 +47,7 @@ * Views. It provides an attribute to retrieve the default view of a * document. *

    See also the Document Object Model (DOM) Level 2 Views Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Views-20001113 Document Object Model (DOM) Level 2 Views Specification * @since 1.8, DOM Level 2 */ public interface DocumentView { diff --git a/src/java.xml/share/classes/org/w3c/dom/views/package-info.java b/src/java.xml/share/classes/org/w3c/dom/views/package-info.java index a2b59efb1c47f..8d687134a2a4c 100644 --- a/src/java.xml/share/classes/org/w3c/dom/views/package-info.java +++ b/src/java.xml/share/classes/org/w3c/dom/views/package-info.java @@ -31,6 +31,7 @@ * the content of a representation of a document. * * + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Views-20001113 Document Object Model (DOM) Level 2 Views Specification * @since 1.8 */ diff --git a/src/jdk.compiler/share/classes/com/sun/source/doctree/package-info.java b/src/jdk.compiler/share/classes/com/sun/source/doctree/package-info.java index 30832c062ff7e..b8ad6dbb1ccb2 100644 --- a/src/jdk.compiler/share/classes/com/sun/source/doctree/package-info.java +++ b/src/jdk.compiler/share/classes/com/sun/source/doctree/package-info.java @@ -27,6 +27,7 @@ * Provides interfaces to represent documentation comments as abstract syntax * trees (AST). * + * @spec javadoc/doc-comment-spec.html Documentation Comment Specification for the Standard Doclet * @author Jonathan Gibbons * @since 1.8 * diff --git a/src/jdk.compiler/share/classes/com/sun/source/util/DocTrees.java b/src/jdk.compiler/share/classes/com/sun/source/util/DocTrees.java index 5a9aee518a147..ecad91f76c938 100644 --- a/src/jdk.compiler/share/classes/com/sun/source/util/DocTrees.java +++ b/src/jdk.compiler/share/classes/com/sun/source/util/DocTrees.java @@ -249,6 +249,7 @@ public abstract void printMessage(Diagnostic.Kind kind, CharSequence msg, * * @param tree the tree containing the entity * @return a string containing the characters + * @spec https://www.w3.org/TR/html52 HTML Standard */ public abstract String getCharacters(EntityTree tree); } diff --git a/src/jdk.httpserver/share/classes/com/sun/net/httpserver/BasicAuthenticator.java b/src/jdk.httpserver/share/classes/com/sun/net/httpserver/BasicAuthenticator.java index ae0ba50f682f2..8cc487dc3ec10 100644 --- a/src/jdk.httpserver/share/classes/com/sun/net/httpserver/BasicAuthenticator.java +++ b/src/jdk.httpserver/share/classes/com/sun/net/httpserver/BasicAuthenticator.java @@ -50,6 +50,7 @@ public abstract class BasicAuthenticator extends Authenticator { * The Basic authentication credentials (username and password) are decoded * using the platform's {@link Charset#defaultCharset() default character set}. * + * @spec https://www.rfc-editor.org/info/rfc7230 RFC 7230: Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing * @apiNote The value of the {@code realm} parameter will be embedded in a * quoted string. * @@ -70,6 +71,7 @@ public BasicAuthenticator(String realm) { * given {@link Charset} to decode the Basic authentication credentials * (username and password). * + * @spec https://www.rfc-editor.org/info/rfc7230 RFC 7230: Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing * @apiNote {@code UTF-8} is the recommended charset because its usage is * communicated to the client, and therefore more likely to be used also * by the client. diff --git a/src/jdk.httpserver/share/classes/com/sun/net/httpserver/package-info.java b/src/jdk.httpserver/share/classes/com/sun/net/httpserver/package-info.java index 3b9de3520fb9f..b5a9763e5fad0 100644 --- a/src/jdk.httpserver/share/classes/com/sun/net/httpserver/package-info.java +++ b/src/jdk.httpserver/share/classes/com/sun/net/httpserver/package-info.java @@ -138,6 +138,8 @@ public void configure (HttpsParameters params) { } }); + @spec https://www.rfc-editor.org/info/rfc2616 RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1 + @spec https://www.rfc-editor.org/info/rfc2818 RFC 2818: HTTP Over TLS @since 1.6 */ package com.sun.net.httpserver; diff --git a/src/jdk.javadoc/share/classes/jdk/javadoc/doclet/StandardDoclet.java b/src/jdk.javadoc/share/classes/jdk/javadoc/doclet/StandardDoclet.java index c57f0d9643e68..297e2348054ff 100644 --- a/src/jdk.javadoc/share/classes/jdk/javadoc/doclet/StandardDoclet.java +++ b/src/jdk.javadoc/share/classes/jdk/javadoc/doclet/StandardDoclet.java @@ -63,6 +63,8 @@ * of {@code

    } and {@code
    } elements. * * + * @spec javadoc/doc-comment-spec.html Documentation Comment Specification for the Standard Doclet + * @spec https://www.w3.org/TR/html52 HTML Standard * @see * Documentation Comment Specification for the Standard Doclet */ diff --git a/src/jdk.javadoc/share/classes/module-info.java b/src/jdk.javadoc/share/classes/module-info.java index b666517e3f09c..f4a0d6101a728 100644 --- a/src/jdk.javadoc/share/classes/module-info.java +++ b/src/jdk.javadoc/share/classes/module-info.java @@ -42,6 +42,7 @@ * or the {@linkplain java.util.ServiceLoader service loader} with the name * {@code "javadoc"}. * + * @spec javadoc/doc-comment-spec.html Documentation Comment Specification for the Standard Doclet * @toolGuide javadoc * * @provides java.util.spi.ToolProvider diff --git a/src/jdk.jdi/share/classes/com/sun/jdi/connect/spi/Connection.java b/src/jdk.jdi/share/classes/com/sun/jdi/connect/spi/Connection.java index 0fe7bed9c095a..60c7b05d26558 100644 --- a/src/jdk.jdi/share/classes/com/sun/jdi/connect/spi/Connection.java +++ b/src/jdk.jdi/share/classes/com/sun/jdi/connect/spi/Connection.java @@ -102,6 +102,7 @@ public Connection() {} * @throws java.io.IOException * If the length of the packet (as indictaed by the first * 4 bytes) is less than 11 bytes, or an I/O error occurs. + * @spec jdwp/jdwp-spec.html Java Debug Wire Protocol * * */ @@ -168,6 +169,7 @@ public Connection() {} * @throws IllegalArgumentException * If the value of the {@code length} field is invalid, * or the byte array is of insufficient length. + * @spec jdwp/jdwp-spec.html Java Debug Wire Protocol */ public abstract void writePacket(byte pkt[]) throws IOException; diff --git a/src/jdk.jdi/share/classes/com/sun/jdi/connect/spi/TransportService.java b/src/jdk.jdi/share/classes/com/sun/jdi/connect/spi/TransportService.java index c3889cb186ab2..839432d89464f 100644 --- a/src/jdk.jdi/share/classes/com/sun/jdi/connect/spi/TransportService.java +++ b/src/jdk.jdi/share/classes/com/sun/jdi/connect/spi/TransportService.java @@ -76,6 +76,8 @@ * method is used to accept a connection initiated by a * target VM. * + * @spec jdwp/jdwp-spec.html Java Debug Wire Protocol + * @spec https://www.rfc-editor.org/info/rfc793 RFC 793: Transmission Control Protocol * @since 1.5 */ public abstract class TransportService { @@ -218,6 +220,7 @@ public Capabilities() {} * If the address is invalid or the value of the * attach timeout or handshake timeout is negative. * + * @spec jdwp/jdwp-spec.html Java Debug Wire Protocol * @see TransportService.Capabilities#supportsAttachTimeout() */ public abstract Connection attach(String address, long attachTimeout, @@ -380,6 +383,7 @@ public ListenKey() {} * called with this listen key and the transport service * is no longer listening for inbound connections. * + * @spec jdwp/jdwp-spec.html Java Debug Wire Protocol * @see TransportService.Capabilities#supportsAcceptTimeout() */ public abstract Connection accept(ListenKey listenKey, long acceptTimeout, diff --git a/src/jdk.jdi/share/classes/module-info.java b/src/jdk.jdi/share/classes/module-info.java index 3bd2f7fc294b5..8f731bb431431 100644 --- a/src/jdk.jdi/share/classes/module-info.java +++ b/src/jdk.jdi/share/classes/module-info.java @@ -104,6 +104,7 @@ * * * + * @spec jpda/jpda.html Java Platform Debugger Architecture * @toolGuide jdb * * @provides com.sun.jdi.connect.Connector diff --git a/src/jdk.jdwp.agent/share/classes/module-info.java b/src/jdk.jdwp.agent/share/classes/module-info.java index 0d7e888e7e963..33e4dfb577b31 100644 --- a/src/jdk.jdwp.agent/share/classes/module-info.java +++ b/src/jdk.jdwp.agent/share/classes/module-info.java @@ -26,6 +26,8 @@ /** * Provides the implementation of the Java Debug Wire Protocol (JDWP) agent. * + * @spec jdwp/jdwp-spec.html Java Debug Wire Protocol + * @spec jdwp/jdwp-transport.html Java Debug Wire Protocol Transport Interface (jdwpTransport) * @moduleGraph * @since 9 * @see JDWP Specification diff --git a/src/jdk.sctp/share/classes/com/sun/nio/sctp/Association.java b/src/jdk.sctp/share/classes/com/sun/nio/sctp/Association.java index 17d05a61a39f8..5026304569f45 100644 --- a/src/jdk.sctp/share/classes/com/sun/nio/sctp/Association.java +++ b/src/jdk.sctp/share/classes/com/sun/nio/sctp/Association.java @@ -49,6 +49,7 @@ * as being given as a parameter to {@link NotificationHandler * NotificationHandler} methods. * + * @spec https://www.rfc-editor.org/info/rfc5061 RFC 5061: Stream Control Transmission Protocol (SCTP) Dynamic Address Reconfiguration * @since 1.7 */ public class Association { diff --git a/src/jdk.sctp/share/classes/com/sun/nio/sctp/MessageInfo.java b/src/jdk.sctp/share/classes/com/sun/nio/sctp/MessageInfo.java index 8fdd4e31bd9ed..1629bc8c40b13 100644 --- a/src/jdk.sctp/share/classes/com/sun/nio/sctp/MessageInfo.java +++ b/src/jdk.sctp/share/classes/com/sun/nio/sctp/MessageInfo.java @@ -54,6 +54,7 @@ * threads. If a MessageInfo is to be used by more than one thread then access * to the MessageInfo should be controlled by appropriate synchronization. * + * @spec https://www.rfc-editor.org/info/rfc3758 RFC 3758: Stream Control Transmission Protocol (SCTP) Partial Reliability Extension * @since 1.7 */ public abstract class MessageInfo { diff --git a/src/jdk.sctp/share/classes/com/sun/nio/sctp/package-info.java b/src/jdk.sctp/share/classes/com/sun/nio/sctp/package-info.java index 513b7392471bb..889e9a1b01b5b 100644 --- a/src/jdk.sctp/share/classes/com/sun/nio/sctp/package-info.java +++ b/src/jdk.sctp/share/classes/com/sun/nio/sctp/package-info.java @@ -69,6 +69,8 @@ * extension for Dynamic Address Reconfiguration is defined by * RFC5061. * + * @spec https://www.rfc-editor.org/info/rfc4960 RFC 4960: Stream Control Transmission Protocol + * @spec https://www.rfc-editor.org/info/rfc5061 RFC 5061: Stream Control Transmission Protocol (SCTP) Dynamic Address Reconfiguration * @since 1.7 */ diff --git a/src/jdk.security.auth/share/classes/com/sun/security/auth/LdapPrincipal.java b/src/jdk.security.auth/share/classes/com/sun/security/auth/LdapPrincipal.java index 6af39422d5ffb..8b08216336c45 100644 --- a/src/jdk.security.auth/share/classes/com/sun/security/auth/LdapPrincipal.java +++ b/src/jdk.security.auth/share/classes/com/sun/security/auth/LdapPrincipal.java @@ -43,6 +43,7 @@ *

    * This class is immutable. * + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names * @since 1.6 */ public final class LdapPrincipal implements Principal, java.io.Serializable { @@ -126,6 +127,7 @@ public String getName() { * If the name has zero components an empty string is returned. * * @return The principal's string name. + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names */ public String toString() { return name.toString(); diff --git a/src/jdk.security.auth/share/classes/com/sun/security/auth/module/LdapLoginModule.java b/src/jdk.security.auth/share/classes/com/sun/security/auth/module/LdapLoginModule.java index 08aa59d239b3d..1ea71252edce6 100644 --- a/src/jdk.security.auth/share/classes/com/sun/security/auth/module/LdapLoginModule.java +++ b/src/jdk.security.auth/share/classes/com/sun/security/auth/module/LdapLoginModule.java @@ -296,6 +296,10 @@ *

    * * + * @spec https://www.rfc-editor.org/info/rfc2253 RFC 2253: Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names + * @spec https://www.rfc-editor.org/info/rfc2254 RFC 2254: The String Representation of LDAP Search Filters + * @spec https://www.rfc-editor.org/info/rfc2255 RFC 2255: The LDAP URL Format + * @spec https://www.rfc-editor.org/info/rfc2782 RFC 2782: A DNS RR for specifying the location of services (DNS SRV) * @since 1.6 */ public class LdapLoginModule implements LoginModule { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSS2Properties.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSS2Properties.java index 56c63fa06d8ae..aea68736d558f 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSS2Properties.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSS2Properties.java @@ -92,6 +92,7 @@ * property with a value of "menu", querying for the values of the component * longhand properties should return the empty string. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface CSS2Properties { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSCharsetRule.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSCharsetRule.java index 1241cacdf5fb5..e46abe0316e42 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSCharsetRule.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSCharsetRule.java @@ -59,6 +59,7 @@ * header, has priority (see CSS document representation) but this is not * reflected in the CSSCharsetRule. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface CSSCharsetRule extends CSSRule { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSFontFaceRule.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSFontFaceRule.java index 1a7e1a1c20cf5..52bd431094ca4 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSFontFaceRule.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSFontFaceRule.java @@ -46,6 +46,7 @@ * a CSS style sheet. The @font-face rule is used to hold a set * of font descriptions. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface CSSFontFaceRule extends CSSRule { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSImportRule.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSImportRule.java index e81d9a0f5832f..0fec875ab74e1 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSImportRule.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSImportRule.java @@ -48,6 +48,7 @@ * a CSS style sheet. The @import rule is used to import style * rules from other style sheets. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface CSSImportRule extends CSSRule { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSMediaRule.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSMediaRule.java index b102a8a57b80b..f21ae13c08c2f 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSMediaRule.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSMediaRule.java @@ -49,6 +49,7 @@ * style sheet. A @media rule can be used to delimit style * rules for specific media types. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface CSSMediaRule extends CSSRule { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSPageRule.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSPageRule.java index fc73252dcb5af..5b9e41ef0a20d 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSPageRule.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSPageRule.java @@ -48,6 +48,7 @@ * CSS style sheet. The @page rule is used to specify the * dimensions, orientation, margins, etc. of a page box for paged media. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface CSSPageRule extends CSSRule { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSPrimitiveValue.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSPrimitiveValue.java index 2646a032d6683..0b7f7278ea4ab 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSPrimitiveValue.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSPrimitiveValue.java @@ -61,6 +61,7 @@ * the range 0-255, a color percentage value can be converted to a number; * (see also the RGBColor interface). *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface CSSPrimitiveValue extends CSSValue { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSRule.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSRule.java index 338f490eb779c..550e510c5c875 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSRule.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSRule.java @@ -50,6 +50,7 @@ * sheet, even if the rule is not recognized by the parser. Unrecognized * rules are represented using the CSSUnknownRule interface. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface CSSRule { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSRuleList.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSRuleList.java index dd6f033bfd47d..ca5aeb825087f 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSRuleList.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSRuleList.java @@ -47,6 +47,7 @@ *

    The items in the CSSRuleList are accessible via an * integral index, starting from 0. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface CSSRuleList { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSStyleDeclaration.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSStyleDeclaration.java index c6bd17f9b2d07..ac5956b7374fe 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSStyleDeclaration.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSStyleDeclaration.java @@ -60,6 +60,7 @@ * interface. The CSS Object Model doesn't provide an access to the * specified or actual values of the CSS cascade. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface CSSStyleDeclaration { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSStyleRule.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSStyleRule.java index 5e0e92dcd8690..e12f07408e669 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSStyleRule.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSStyleRule.java @@ -47,6 +47,7 @@ * The CSSStyleRule interface represents a single rule set in a * CSS style sheet. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface CSSStyleRule extends CSSRule { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSStyleSheet.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSStyleSheet.java index 2c021dc6c4565..b7fa2ea155e20 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSStyleSheet.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSStyleSheet.java @@ -49,6 +49,7 @@ * represent a CSS style sheet i.e., a style sheet whose content type is * "text/css". *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface CSSStyleSheet extends StyleSheet { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSUnknownRule.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSUnknownRule.java index 8b7b3f6d29ed9..20ea002599725 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSUnknownRule.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSUnknownRule.java @@ -45,6 +45,7 @@ * The CSSUnknownRule interface represents an at-rule not * supported by this user agent. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface CSSUnknownRule extends CSSRule { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSValue.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSValue.java index 54aa703ffe9a1..9bcc9fe63ac7d 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSValue.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSValue.java @@ -48,6 +48,7 @@ * value. A CSSValue object only occurs in a context of a CSS * property. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface CSSValue { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSValueList.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSValueList.java index db62e1c7c9eb4..81ac1cfc8844d 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSValueList.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/CSSValueList.java @@ -50,6 +50,7 @@ *

    The items in the CSSValueList are accessible via an * integral index, starting from 0. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface CSSValueList extends CSSValue { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/Counter.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/Counter.java index 9da6a1980b403..ce02dde9cffaa 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/Counter.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/Counter.java @@ -46,6 +46,7 @@ * counters function value. This interface reflects the values in the * underlying style property. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface Counter { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/DOMImplementationCSS.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/DOMImplementationCSS.java index b047fcb0f557b..caf17721992d9 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/DOMImplementationCSS.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/DOMImplementationCSS.java @@ -49,6 +49,7 @@ * outside the context of a document. There is no way to associate the new * CSSStyleSheet with a document in DOM Level 2. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface DOMImplementationCSS extends DOMImplementation { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/DocumentCSS.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/DocumentCSS.java index f68b9e2d45808..0b88aa625feb6 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/DocumentCSS.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/DocumentCSS.java @@ -62,6 +62,7 @@ * interface can be obtained by using binding-specific casting methods on an * instance of the Document interface. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface DocumentCSS extends DocumentStyle { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/ElementCSSInlineStyle.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/ElementCSSInlineStyle.java index 6f10e6d2dc925..64f1acd8a0a8f 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/ElementCSSInlineStyle.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/ElementCSSInlineStyle.java @@ -50,6 +50,7 @@ * binding-specific casting methods on an instance of the Element interface * when the element supports inline CSS style information. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface ElementCSSInlineStyle { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/RGBColor.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/RGBColor.java index 00bb4514c2597..56c0edd081257 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/RGBColor.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/RGBColor.java @@ -55,6 +55,7 @@ *

    A color percentage value can always be converted to a number and vice * versa. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface RGBColor { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/Rect.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/Rect.java index e8e0a73db15b1..ac6c205f7890a 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/Rect.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/Rect.java @@ -47,6 +47,7 @@ * modifications made to the CSSPrimitiveValue objects modify * the style property. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface Rect { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/ViewCSS.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/ViewCSS.java index caf705c9e6193..316c9324cba5b 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/ViewCSS.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/ViewCSS.java @@ -55,6 +55,7 @@ * CSSStyleDeclaration and CSSValue related to * this declaration are no longer valid. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface ViewCSS extends AbstractView { @@ -65,6 +66,7 @@ public interface ViewCSS extends AbstractView { * @param pseudoElt The pseudo-element or null if none. * @return The computed style. The CSSStyleDeclaration is * read-only and contains only absolute values. + * @spec https://www.w3.org/TR/1998/REC-CSS2-19980512 Cascading Style Sheets, Level 2 */ public CSSStyleDeclaration getComputedStyle(Element elt, String pseudoElt); diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/package-info.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/package-info.java index ae2acd8116b54..08e8ef58b03f7 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/css/package-info.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/css/package-info.java @@ -32,6 +32,7 @@ * dynamically access and update the content of style sheets documents. * * + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4 */ diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLAnchorElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLAnchorElement.java index 9eb9f85c167d5..44be37fe1ac50 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLAnchorElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLAnchorElement.java @@ -45,6 +45,7 @@ * The anchor element. See the A element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLAnchorElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLAppletElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLAppletElement.java index 21ab47b978923..12e7f2ad2792f 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLAppletElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLAppletElement.java @@ -46,6 +46,7 @@ * This element is deprecated in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLAppletElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLAreaElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLAreaElement.java index 743d3991a1891..52d036c0ce872 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLAreaElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLAreaElement.java @@ -46,6 +46,7 @@ * HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLAreaElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLBRElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLBRElement.java index 3745d48ec6b24..4ce3ab7ec1aa0 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLBRElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLBRElement.java @@ -45,6 +45,7 @@ * Force a line break. See the BR element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLBRElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLBaseElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLBaseElement.java index 473b492e66dc4..564603f78f42c 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLBaseElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLBaseElement.java @@ -45,6 +45,7 @@ * Document base URI. See the BASE element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLBaseElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLBaseFontElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLBaseFontElement.java index 327ef9d6e4d56..7bd771a642ff9 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLBaseFontElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLBaseFontElement.java @@ -46,6 +46,7 @@ * is deprecated in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLBaseFontElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLBodyElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLBodyElement.java index ad14b86d9fcb2..918fe3eafa1ae 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLBodyElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLBodyElement.java @@ -47,6 +47,7 @@ * element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLBodyElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLButtonElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLButtonElement.java index 578b68605fb05..fcacac38eb054 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLButtonElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLButtonElement.java @@ -45,6 +45,7 @@ * Push button. See the BUTTON element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLButtonElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLCollection.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLCollection.java index f59ae97a8042b..10fa82b716bd8 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLCollection.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLCollection.java @@ -51,6 +51,7 @@ * underlying document is changed. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLCollection { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLDListElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLDListElement.java index 3b7475817e7cd..dccad86c9087f 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLDListElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLDListElement.java @@ -45,6 +45,7 @@ * Definition list. See the DL element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLDListElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLDirectoryElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLDirectoryElement.java index 19fbc96b02391..b9986bf75913f 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLDirectoryElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLDirectoryElement.java @@ -46,6 +46,7 @@ * is deprecated in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLDirectoryElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLDivElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLDivElement.java index f204f284a2e78..2c8459c816c8f 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLDivElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLDivElement.java @@ -45,6 +45,7 @@ * Generic block container. See the DIV element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLDivElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLDocument.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLDocument.java index 06e6eb7c6ae62..4df564be3fa21 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLDocument.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLDocument.java @@ -56,6 +56,7 @@ * interface where it was moved. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLDocument extends Document { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLElement.java index cc0727ee570c5..b528f5b097b7b 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLElement.java @@ -54,6 +54,7 @@ * ElementCSSInlineStyle interface which is defined in the . *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLElement extends Element { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLFieldSetElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLFieldSetElement.java index 0c650d1d9701b..e44fb19f24074 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLFieldSetElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLFieldSetElement.java @@ -46,6 +46,7 @@ * definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLFieldSetElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLFontElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLFontElement.java index b9a0c7b919cde..18fe6ee9ae5a1 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLFontElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLFontElement.java @@ -46,6 +46,7 @@ * element is deprecated in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLFontElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLFormElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLFormElement.java index 0c00bd2733495..ec07aa009ec20 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLFormElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLFormElement.java @@ -48,6 +48,7 @@ * definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLFormElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLFrameElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLFrameElement.java index 92891a90c32c7..3838b1e145047 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLFrameElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLFrameElement.java @@ -47,6 +47,7 @@ * Create a frame. See the FRAME element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLFrameElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLFrameSetElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLFrameSetElement.java index 60112d7ada831..42df681a5e77d 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLFrameSetElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLFrameSetElement.java @@ -45,6 +45,7 @@ * Create a grid of frames. See the FRAMESET element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLFrameSetElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLHRElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLHRElement.java index c0fbfda600ed3..eda5f1fc9579c 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLHRElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLHRElement.java @@ -45,6 +45,7 @@ * Create a horizontal rule. See the HR element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLHRElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLHeadElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLHeadElement.java index 319e6a587412a..5f362eedc3075 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLHeadElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLHeadElement.java @@ -45,6 +45,7 @@ * Document head information. See the HEAD element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLHeadElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLHeadingElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLHeadingElement.java index f46bf5b0a95b0..dc117d2cfc1ad 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLHeadingElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLHeadingElement.java @@ -46,6 +46,7 @@ * definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLHeadingElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLHtmlElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLHtmlElement.java index 75a6cfa80f149..ff02e0be1fefa 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLHtmlElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLHtmlElement.java @@ -45,6 +45,7 @@ * Root of an HTML document. See the HTML element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLHtmlElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLIFrameElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLIFrameElement.java index 7a7ffd64d99c3..919c0cbc32987 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLIFrameElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLIFrameElement.java @@ -47,6 +47,7 @@ * Inline subwindows. See the IFRAME element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLIFrameElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLImageElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLImageElement.java index 238464de9450d..37cfc3e87c21d 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLImageElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLImageElement.java @@ -45,6 +45,7 @@ * Embedded image. See the IMG element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLImageElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLInputElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLInputElement.java index 15d6d0351841c..d44b434781fd5 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLInputElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLInputElement.java @@ -49,6 +49,7 @@ * in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLInputElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLIsIndexElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLIsIndexElement.java index 2766c9ee8ec12..75f437f0d7395 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLIsIndexElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLIsIndexElement.java @@ -46,6 +46,7 @@ * definition in HTML 4.0. This element is deprecated in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLIsIndexElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLLIElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLLIElement.java index e368c51797cd5..aa4e90031a8e1 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLLIElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLLIElement.java @@ -45,6 +45,7 @@ * List item. See the LI element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLLIElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLLabelElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLLabelElement.java index d9bc78a5d1503..7f43dd04ba684 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLLabelElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLLabelElement.java @@ -45,6 +45,7 @@ * Form field label text. See the LABEL element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLLabelElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLLegendElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLLegendElement.java index f9b54902d8353..f70742e2a87b3 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLLegendElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLLegendElement.java @@ -46,6 +46,7 @@ * element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLLegendElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLLinkElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLLinkElement.java index 0824d0c823a8e..2ba28c8af0550 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLLinkElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLLinkElement.java @@ -48,6 +48,7 @@ * LinkStyle interface in the module). *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLLinkElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLMapElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLMapElement.java index cb834e648724b..6a3ff49001f41 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLMapElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLMapElement.java @@ -45,6 +45,7 @@ * Client-side image map. See the MAP element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLMapElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLMenuElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLMenuElement.java index cd7ea2b2108a0..b0a2c9aa95bd6 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLMenuElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLMenuElement.java @@ -46,6 +46,7 @@ * deprecated in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLMenuElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLMetaElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLMetaElement.java index 4b6e25384487f..16dfa423a4645 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLMetaElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLMetaElement.java @@ -46,6 +46,7 @@ * element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLMetaElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLModElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLModElement.java index 17e36db665d02..a31876e58f90f 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLModElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLModElement.java @@ -46,6 +46,7 @@ * element definitions in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLModElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLOListElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLOListElement.java index 9599c48182aae..5a400703c07d4 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLOListElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLOListElement.java @@ -45,6 +45,7 @@ * Ordered list. See the OL element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLOListElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLObjectElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLObjectElement.java index 2e1e631dfa224..79611c15eaa3a 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLObjectElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLObjectElement.java @@ -50,6 +50,7 @@ * element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLObjectElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLOptGroupElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLOptGroupElement.java index de00e8ca0383f..7184042293bc4 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLOptGroupElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLOptGroupElement.java @@ -46,6 +46,7 @@ * definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLOptGroupElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLOptionElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLOptionElement.java index 22e348bdfdf5c..68591dfd76f97 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLOptionElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLOptionElement.java @@ -45,6 +45,7 @@ * A selectable choice. See the OPTION element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLOptionElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLParagraphElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLParagraphElement.java index c5e43b4d8f62c..b4f48ba33b823 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLParagraphElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLParagraphElement.java @@ -45,6 +45,7 @@ * Paragraphs. See the P element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLParagraphElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLParamElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLParamElement.java index b7b86648dd301..2fa6f32dff2b5 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLParamElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLParamElement.java @@ -46,6 +46,7 @@ * definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLParamElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLPreElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLPreElement.java index a8bce79253ff3..befec4fbc0f3a 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLPreElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLPreElement.java @@ -45,6 +45,7 @@ * Preformatted text. See the PRE element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLPreElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLQuoteElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLQuoteElement.java index db0b10de89168..37b725ea294d8 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLQuoteElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLQuoteElement.java @@ -46,6 +46,7 @@ * element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLQuoteElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLScriptElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLScriptElement.java index 9931a02817d1b..420163c2514f6 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLScriptElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLScriptElement.java @@ -45,6 +45,7 @@ * Script statements. See the SCRIPT element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLScriptElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLSelectElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLSelectElement.java index 85d6c21ea1d89..9a27e5c73a7b5 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLSelectElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLSelectElement.java @@ -49,6 +49,7 @@ * collection. See the SELECT element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLSelectElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLStyleElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLStyleElement.java index 5e7b99fb38f52..d033a50fe74da 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLStyleElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLStyleElement.java @@ -46,6 +46,7 @@ * module and the LinkStyle interface in the module. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLStyleElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableCaptionElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableCaptionElement.java index f2126d36091a0..6b141521fd8e1 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableCaptionElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableCaptionElement.java @@ -45,6 +45,7 @@ * Table caption See the CAPTION element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLTableCaptionElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableCellElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableCellElement.java index 53b41023e50c7..7f5c20bba34fa 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableCellElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableCellElement.java @@ -46,6 +46,7 @@ * elements. See the TD element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLTableCellElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableColElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableColElement.java index fcf413f5270db..6ca612b786ada 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableColElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableColElement.java @@ -46,6 +46,7 @@ * COL element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLTableColElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableElement.java index d73421aba5cf8..c3537d8b5dd53 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableElement.java @@ -53,6 +53,7 @@ * 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLTableElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableRowElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableRowElement.java index fed6b205b2cfb..2024cfc7f8779 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableRowElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableRowElement.java @@ -47,6 +47,7 @@ * A row in a table. See the TR element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLTableRowElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableSectionElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableSectionElement.java index e68156d35ebeb..26f1ce0de45c2 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableSectionElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableSectionElement.java @@ -48,6 +48,7 @@ * elements. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLTableSectionElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTextAreaElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTextAreaElement.java index 85afebaaa2101..48b46080f44c1 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTextAreaElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTextAreaElement.java @@ -45,6 +45,7 @@ * Multi-line text field. See the TEXTAREA element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLTextAreaElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTitleElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTitleElement.java index 166f783c0ea53..68a15d7186c55 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTitleElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTitleElement.java @@ -45,6 +45,7 @@ * The document title. See the TITLE element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLTitleElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLUListElement.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLUListElement.java index b58342ed1dc90..0e651b043c10b 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLUListElement.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLUListElement.java @@ -45,6 +45,7 @@ * Unordered list. See the UL element definition in HTML 4.0. *

    See also the Document Object Model (DOM) Level 2 Specification. * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification * @since 1.4, DOM Level 2 */ public interface HTMLUListElement extends HTMLElement { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/package-info.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/package-info.java index 3cc7ddd9a0ad9..3a4e4f2b16c70 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/html/package-info.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/html/package-info.java @@ -33,6 +33,8 @@ * HTML 4.0 Specification. * * + * @spec https://www.w3.org/TR/DOM-Level-2 Document Object Model (DOM) Level 2 Specification + * @spec https://www.w3.org/TR/1998/REC-html40-19980424 HTML 4.0 Specification * @since 1.4 */ diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/DocumentStyle.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/DocumentStyle.java index 2c8ce7059d715..e0fbe40fe8ff2 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/DocumentStyle.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/DocumentStyle.java @@ -48,6 +48,7 @@ * obtained by using binding-specific casting methods on an instance of the * Document interface. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface DocumentStyle { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/LinkStyle.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/LinkStyle.java index 496bc641f9fc4..f4469bb3cf1bd 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/LinkStyle.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/LinkStyle.java @@ -49,6 +49,7 @@ * linking node (HTMLLinkElement, HTMLStyleElement * or ProcessingInstruction in DOM Level 2). *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface LinkStyle { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/MediaList.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/MediaList.java index ba57166449209..caf69c17160ae 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/MediaList.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/MediaList.java @@ -51,6 +51,7 @@ *

    The items in the MediaList are accessible via an integral * index, starting from 0. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface MediaList { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/StyleSheet.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/StyleSheet.java index 40df308881865..2a1f734df7e03 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/StyleSheet.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/StyleSheet.java @@ -51,6 +51,7 @@ * an inline STYLE element. In XML, this interface represents an external * style sheet, included via a style sheet processing instruction. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface StyleSheet { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/StyleSheetList.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/StyleSheetList.java index 468f0c1815dab..e00d4726d25ba 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/StyleSheetList.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/StyleSheetList.java @@ -47,6 +47,7 @@ *

    The items in the StyleSheetList are accessible via an * integral index, starting from 0. *

    See also the Document Object Model (DOM) Level 2 Style Specification. + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4, DOM Level 2 */ public interface StyleSheetList { diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/package-info.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/package-info.java index d4c8037c5c9b5..f30d9d183cbec 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/package-info.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/stylesheets/package-info.java @@ -32,6 +32,7 @@ * dynamically access and update the content of style sheets documents. * * + * @spec https://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113 Document Object Model (DOM) Level 2 Style Specification * @since 1.4 */ diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathEvaluator.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathEvaluator.java index 734a3c55febc5..ca0eb45ce96d5 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathEvaluator.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathEvaluator.java @@ -62,6 +62,7 @@ * extension functions or variables as would be defined by other * specifications. *

    See also the Document Object Model (DOM) Level 3 XPath Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-XPath Document Object Model (DOM) Level 3 XPath Specification */ public interface XPathEvaluator { /** diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathException.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathException.java index 2941f9eed03f8..75862bf8ebfe6 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathException.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathException.java @@ -52,6 +52,7 @@ * Specification, Working Draft 20 August 2002 where the values of * {@link #INVALID_EXPRESSION_ERR} and {@link #TYPE_ERR} * are 1 and 2 respectively (instead of 51 and 52 as in the 2004 version). + * @spec https://www.w3.org/TR/DOM-Level-3-XPath Document Object Model (DOM) Level 3 XPath Specification */ public class XPathException extends RuntimeException { private static final long serialVersionUID = 3471034171575979943L; diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathExpression.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathExpression.java index 9c846d01aaacb..dd73ccb4e44f9 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathExpression.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathExpression.java @@ -49,6 +49,7 @@ * The XPathExpression interface represents a parsed and resolved * XPath expression. *

    See also the Document Object Model (DOM) Level 3 XPath Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-XPath Document Object Model (DOM) Level 3 XPath Specification */ public interface XPathExpression { /** diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathNSResolver.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathNSResolver.java index a44d9bea785df..1fc76e7226c11 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathNSResolver.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathNSResolver.java @@ -49,6 +49,7 @@ * construct an implementation of XPathNSResolver from a node, * or the interface may be implemented by any application. *

    See also the Document Object Model (DOM) Level 3 XPath Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-XPath Document Object Model (DOM) Level 3 XPath Specification */ public interface XPathNSResolver { /** diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathNamespace.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathNamespace.java index a6932ec017fbe..378c1eb2dd493 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathNamespace.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathNamespace.java @@ -75,6 +75,7 @@ * node may be changed incomatibly, in which case incompatible changes to * field values may be required to implement versions beyond XPath 1.0. *

    See also the Document Object Model (DOM) Level 3 XPath Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-XPath Document Object Model (DOM) Level 3 XPath Specification */ public interface XPathNamespace extends Node { // XPathNodeType diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathResult.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathResult.java index ca8b341f7b75f..587d673cf5f1e 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathResult.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/XPathResult.java @@ -52,6 +52,7 @@ * result types, this object makes it possible to discover and manipulate * the type and value of the result. *

    See also the Document Object Model (DOM) Level 3 XPath Specification. + * @spec https://www.w3.org/TR/DOM-Level-3-XPath Document Object Model (DOM) Level 3 XPath Specification */ public interface XPathResult { // XPathResultType diff --git a/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/package-info.java b/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/package-info.java index ed8004e226a53..6ebf2ed194d7e 100644 --- a/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/package-info.java +++ b/src/jdk.xml.dom/share/classes/org/w3c/dom/xpath/package-info.java @@ -37,6 +37,8 @@ * {@link XPathException#INVALID_EXPRESSION_ERR} and {@link XPathException#TYPE_ERR} * are 1 and 2 respectively (instead of 51 and 52). * + * @spec https://www.w3.org/TR/DOM-Level-3-XPath Document Object Model (DOM) Level 3 XPath Specification + * @spec https://www.w3.org/TR/1999/REC-xpath-19991116 XML Path Language (XPath) * @since 1.4 */