OpenJDK / bsd-port / bsd-port / jdk
changeset 8555:cac5fa70a888
8016217: More javadoc warnings
Reviewed-by: lancea, chegar, psandoz
line wrap: on
line diff
--- a/src/share/classes/java/io/BufferedInputStream.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/io/BufferedInputStream.java Tue Jan 24 00:25:46 2017 +0000 @@ -185,7 +185,7 @@ * * @param in the underlying input stream. * @param size the buffer size. - * @exception IllegalArgumentException if size <= 0. + * @exception IllegalArgumentException if {@code size <= 0}. */ public BufferedInputStream(InputStream in, int size) { super(in);
--- a/src/share/classes/java/io/BufferedReader.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/io/BufferedReader.java Tue Jan 24 00:25:46 2017 +0000 @@ -88,7 +88,7 @@ * @param in A Reader * @param sz Input-buffer size * - * @exception IllegalArgumentException If sz is <= 0 + * @exception IllegalArgumentException If {@code sz <= 0} */ public BufferedReader(Reader in, int sz) { super(in); @@ -477,7 +477,7 @@ * whose size is no smaller than limit. * Therefore large values should be used with care. * - * @exception IllegalArgumentException If readAheadLimit is < 0 + * @exception IllegalArgumentException If {@code readAheadLimit < 0} * @exception IOException If an I/O error occurs */ public void mark(int readAheadLimit) throws IOException {
--- a/src/share/classes/java/io/BufferedWriter.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/io/BufferedWriter.java Tue Jan 24 00:25:46 2017 +0000 @@ -95,7 +95,7 @@ * @param out A Writer * @param sz Output-buffer size, a positive integer * - * @exception IllegalArgumentException If sz is <= 0 + * @exception IllegalArgumentException If {@code sz <= 0} */ public BufferedWriter(Writer out, int sz) { super(out);
--- a/src/share/classes/java/io/Console.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/io/Console.java Tue Jan 24 00:25:46 2017 +0000 @@ -75,7 +75,7 @@ * manually zero the returned character array after processing to minimize the * lifetime of sensitive data in memory. * - * <blockquote><pre> + * <blockquote><pre>{@code * Console cons; * char[] passwd; * if ((cons = System.console()) != null && @@ -83,7 +83,7 @@ * ... * java.util.Arrays.fill(passwd, ' '); * } - * </pre></blockquote> + * }</pre></blockquote> * * @author Xueming Shen * @since 1.6
--- a/src/share/classes/java/io/PipedInputStream.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/io/PipedInputStream.java Tue Jan 24 00:25:46 2017 +0000 @@ -117,7 +117,7 @@ * @param src the stream to connect to. * @param pipeSize the size of the pipe's buffer. * @exception IOException if an I/O error occurs. - * @exception IllegalArgumentException if <code>pipeSize <= 0</code>. + * @exception IllegalArgumentException if {@code pipeSize <= 0}. * @since 1.6 */ public PipedInputStream(PipedOutputStream src, int pipeSize) @@ -147,7 +147,7 @@ * connected} to a <code>PipedOutputStream</code> before being used. * * @param pipeSize the size of the pipe's buffer. - * @exception IllegalArgumentException if <code>pipeSize <= 0</code>. + * @exception IllegalArgumentException if {@code pipeSize <= 0}. * @since 1.6 */ public PipedInputStream(int pipeSize) {
--- a/src/share/classes/java/io/PipedReader.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/io/PipedReader.java Tue Jan 24 00:25:46 2017 +0000 @@ -91,7 +91,7 @@ * @param src the stream to connect to. * @param pipeSize the size of the pipe's buffer. * @exception IOException if an I/O error occurs. - * @exception IllegalArgumentException if <code>pipeSize <= 0</code>. + * @exception IllegalArgumentException if {@code pipeSize <= 0}. * @since 1.6 */ public PipedReader(PipedWriter src, int pipeSize) throws IOException { @@ -120,7 +120,7 @@ * before being used. * * @param pipeSize the size of the pipe's buffer. - * @exception IllegalArgumentException if <code>pipeSize <= 0</code>. + * @exception IllegalArgumentException if {@code pipeSize <= 0}. * @since 1.6 */ public PipedReader(int pipeSize) {
--- a/src/share/classes/java/io/PrintStream.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/io/PrintStream.java Tue Jan 24 00:25:46 2017 +0000 @@ -851,7 +851,7 @@ * <tt>null</tt> argument depends on the <a * href="../util/Formatter.html#syntax">conversion</a>. * - * @throws IllegalFormatException + * @throws java.util.IllegalFormatException * If a format string contains an illegal syntax, a format * specifier that is incompatible with the given arguments, * insufficient arguments given the format string, or other @@ -901,7 +901,7 @@ * <tt>null</tt> argument depends on the <a * href="../util/Formatter.html#syntax">conversion</a>. * - * @throws IllegalFormatException + * @throws java.util.IllegalFormatException * If a format string contains an illegal syntax, a format * specifier that is incompatible with the given arguments, * insufficient arguments given the format string, or other @@ -944,7 +944,7 @@ * <tt>null</tt> argument depends on the <a * href="../util/Formatter.html#syntax">conversion</a>. * - * @throws IllegalFormatException + * @throws java.util.IllegalFormatException * If a format string contains an illegal syntax, a format * specifier that is incompatible with the given arguments, * insufficient arguments given the format string, or other @@ -1001,7 +1001,7 @@ * <tt>null</tt> argument depends on the <a * href="../util/Formatter.html#syntax">conversion</a>. * - * @throws IllegalFormatException + * @throws java.util.IllegalFormatException * If a format string contains an illegal syntax, a format * specifier that is incompatible with the given arguments, * insufficient arguments given the format string, or other
--- a/src/share/classes/java/io/PushbackInputStream.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/io/PushbackInputStream.java Tue Jan 24 00:25:46 2017 +0000 @@ -85,7 +85,7 @@ * * @param in the input stream from which bytes will be read. * @param size the size of the pushback buffer. - * @exception IllegalArgumentException if size is <= 0 + * @exception IllegalArgumentException if {@code size <= 0} * @since JDK1.1 */ public PushbackInputStream(InputStream in, int size) {
--- a/src/share/classes/java/io/PushbackReader.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/io/PushbackReader.java Tue Jan 24 00:25:46 2017 +0000 @@ -47,7 +47,7 @@ * * @param in The reader from which characters will be read * @param size The size of the pushback buffer - * @exception IllegalArgumentException if size is <= 0 + * @exception IllegalArgumentException if {@code size <= 0} */ public PushbackReader(Reader in, int size) { super(in);
--- a/src/share/classes/java/io/StringReader.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/io/StringReader.java Tue Jan 24 00:25:46 2017 +0000 @@ -163,7 +163,7 @@ * is no actual limit, so this argument must not * be negative, but is otherwise ignored. * - * @exception IllegalArgumentException If readAheadLimit is < 0 + * @exception IllegalArgumentException If {@code readAheadLimit < 0} * @exception IOException If an I/O error occurs */ public void mark(int readAheadLimit) throws IOException {
--- a/src/share/classes/java/lang/Character.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/lang/Character.java Tue Jan 24 00:25:46 2017 +0000 @@ -4585,9 +4585,9 @@ * Unicode surrogate pair</a>. * <p>This method is equivalent to the expression: - * <blockquote><pre> + * <blockquote><pre>{@code * isHighSurrogate(high) && isLowSurrogate(low) - * </pre></blockquote> + * }</pre></blockquote> * * @param high the high-surrogate code value to be tested * @param low the low-surrogate code value to be tested
--- a/src/share/classes/java/lang/ClassLoader.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/lang/ClassLoader.java Tue Jan 24 00:25:46 2017 +0000 @@ -749,7 +749,7 @@ * bootstrap class loader. If <tt>name</tt> is not <tt>null</tt>, it * must be equal to the <a href="#name">binary name</a> of the class * specified by the byte array "<tt>b</tt>", otherwise a {@link - * <tt>NoClassDefFoundError</tt>} will be thrown. </p> + * NoClassDefFoundError <tt>NoClassDefFoundError</tt>} will be thrown. </p> * * @param name * The expected <a href="#name">binary name</a> of the class, or
--- a/src/share/classes/java/lang/Comparable.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/lang/Comparable.java Tue Jan 24 00:25:46 2017 +0000 @@ -56,7 +56,7 @@ * method.<p> * * For example, if one adds two keys <tt>a</tt> and <tt>b</tt> such that - * <tt>(!a.equals(b) && a.compareTo(b) == 0)</tt> to a sorted + * {@code (!a.equals(b) && a.compareTo(b) == 0)} to a sorted * set that does not use an explicit comparator, the second <tt>add</tt> * operation returns false (and the size of the sorted set does not increase) * because <tt>a</tt> and <tt>b</tt> are equivalent from the sorted set's
--- a/src/share/classes/java/lang/Double.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/lang/Double.java Tue Jan 24 00:25:46 2017 +0000 @@ -879,13 +879,13 @@ * <p>In all other cases, let <i>s</i>, <i>e</i>, and <i>m</i> be three * values that can be computed from the argument: * - * <blockquote><pre> - * int s = ((bits >> 63) == 0) ? 1 : -1; - * int e = (int)((bits >> 52) & 0x7ffL); + * <blockquote><pre>{@code + * int s = ((bits >> 63) == 0) ? 1 : -1; + * int e = (int)((bits >> 52) & 0x7ffL); * long m = (e == 0) ? - * (bits & 0xfffffffffffffL) << 1 : + * (bits & 0xfffffffffffffL) << 1 : * (bits & 0xfffffffffffffL) | 0x10000000000000L; - * </pre></blockquote> + * }</pre></blockquote> * * Then the floating-point result equals the value of the mathematical * expression <i>s</i>·<i>m</i>·2<sup><i>e</i>-1075</sup>.
--- a/src/share/classes/java/lang/Float.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/lang/Float.java Tue Jan 24 00:25:46 2017 +0000 @@ -782,13 +782,13 @@ * <p>In all other cases, let <i>s</i>, <i>e</i>, and <i>m</i> be three * values that can be computed from the argument: * - * <blockquote><pre> - * int s = ((bits >> 31) == 0) ? 1 : -1; - * int e = ((bits >> 23) & 0xff); + * <blockquote><pre>{@code + * int s = ((bits >> 31) == 0) ? 1 : -1; + * int e = ((bits >> 23) & 0xff); * int m = (e == 0) ? - * (bits & 0x7fffff) << 1 : + * (bits & 0x7fffff) << 1 : * (bits & 0x7fffff) | 0x800000; - * </pre></blockquote> + * }</pre></blockquote> * * Then the floating-point result equals the value of the mathematical * expression <i>s</i>·<i>m</i>·2<sup><i>e</i>-150</sup>.
--- a/src/share/classes/java/lang/StackTraceElement.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/lang/StackTraceElement.java Tue Jan 24 00:25:46 2017 +0000 @@ -181,12 +181,12 @@ * {@code StackTraceElement} instance representing the same execution * point as this instance. Two stack trace elements {@code a} and * {@code b} are equal if and only if: - * <pre> + * <pre>{@code * equals(a.getFileName(), b.getFileName()) && * a.getLineNumber() == b.getLineNumber()) && * equals(a.getClassName(), b.getClassName()) && * equals(a.getMethodName(), b.getMethodName()) - * </pre> + * }</pre> * where {@code equals} has the semantics of {@link * java.util.Objects#equals(Object, Object) Objects.equals}. *
--- a/src/share/classes/java/lang/instrument/Instrumentation.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/lang/instrument/Instrumentation.java Tue Jan 24 00:25:46 2017 +0000 @@ -593,24 +593,28 @@ * and the normal automatic resolution. For * <code>RegisterNatives</code>, the JVM will attempt this * association: - * <pre> - * method(foo) -> nativeImplementation(foo)</pre> + * <pre>{@code + * method(foo) -> nativeImplementation(foo) + * }</pre> * <p/> * When this fails, the resolution will be retried with * the specified prefix prepended to the method name, * yielding the correct resolution: - * <pre> - * method(wrapped_foo) -> nativeImplementation(foo)</pre> + * <pre>{@code + * method(wrapped_foo) -> nativeImplementation(foo) + * }</pre> * <p/> * For automatic resolution, the JVM will attempt: - * <pre> - * method(wrapped_foo) -> nativeImplementation(wrapped_foo)</pre> + * <pre>{@code + * method(wrapped_foo) -> nativeImplementation(wrapped_foo) + * }</pre> * <p/> * When this fails, the resolution will be retried with * the specified prefix deleted from the implementation name, * yielding the correct resolution: - * <pre> - * method(wrapped_foo) -> nativeImplementation(foo)</pre> + * <pre>{@code + * method(wrapped_foo) -> nativeImplementation(foo) + * }</pre> * <p/> * Note that since the prefix is only used when standard * resolution fails, native methods can be wrapped selectively.
--- a/src/share/classes/java/lang/invoke/MethodHandle.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/lang/invoke/MethodHandle.java Tue Jan 24 00:25:46 2017 +0000 @@ -251,7 +251,7 @@ * * <h3>Usage examples</h3> * Here are some examples of usage: - * <p><blockquote><pre> + * <p><blockquote><pre>{@code Object x, y; String s; int i; MethodType mt; MethodHandle mh; MethodHandles.Lookup lookup = MethodHandles.lookup(); @@ -287,7 +287,7 @@ mh = lookup.findVirtual(java.io.PrintStream.class, "println", mt); mh.invokeExact(System.out, "Hello, world."); // invokeExact(Ljava/io/PrintStream;Ljava/lang/String;)V - * </pre></blockquote> + * }</pre></blockquote> * Each of the above calls to {@code invokeExact} or plain {@code invoke} * generates a single invokevirtual instruction with * the symbolic type descriptor indicated in the following comment. @@ -758,7 +758,7 @@ * an {@link IllegalArgumentException} instead of invoking the target. * <p> * Here are some simple examples of array-spreading method handles: - * <blockquote><pre> + * <blockquote><pre>{@code MethodHandle equals = publicLookup() .findVirtual(String.class, "equals", methodType(boolean.class, Object.class)); assert( (boolean) equals.invokeExact("me", (Object)"me")); @@ -800,7 +800,7 @@ assertEquals("[A, B, C]", (String) caString3.invokeExact('A', 'B', 'C')); MethodHandle caToString2 = caString3.asSpreader(char[].class, 2); assertEquals("[A, B, C]", (String) caToString2.invokeExact('A', "BC".toCharArray())); - * </pre></blockquote> + * }</pre></blockquote> * @param arrayType usually {@code Object[]}, the type of the array argument from which to extract the spread arguments * @param arrayLength the number of arguments to spread from an incoming array argument * @return a new method handle which spreads its final array argument, @@ -888,7 +888,7 @@ * number of collected arguments, use {@link #asVarargsCollector asVarargsCollector} instead. * <p> * Here are some examples of array-collecting method handles: - * <blockquote><pre> + * <blockquote><pre>{@code MethodHandle deepToString = publicLookup() .findStatic(Arrays.class, "deepToString", methodType(String.class, Object[].class)); assertEquals("[won]", (String) deepToString.invokeExact(new Object[]{"won"})); @@ -914,7 +914,7 @@ .findStatic(Arrays.class, "toString", methodType(String.class, long[].class)) .asCollector(long[].class, 1); assertEquals("[123]", (String) longsToString.invokeExact((long)123)); - * </pre></blockquote> + * }</pre></blockquote> * @param arrayType often {@code Object[]}, the type of the array argument which will collect the arguments * @param arrayLength the number of arguments to collect into a new array argument * @return a new method handle which collects some trailing argument @@ -1051,7 +1051,7 @@ * It may (or may not) return the original variable arity method handle. * <p> * Here is an example, of a list-making variable arity method handle: - * <blockquote><pre> + * <blockquote><pre>{@code MethodHandle deepToString = publicLookup() .findStatic(Arrays.class, "deepToString", methodType(String.class, Object[].class)); MethodHandle ts1 = deepToString.asVarargsCollector(Object[].class); @@ -1073,7 +1073,7 @@ List ls = (List) asList.invoke((Object)argv); assertEquals(1, ls.size()); assertEquals("[three, thee, tee]", Arrays.toString((Object[])ls.get(0))); - * </pre></blockquote> + * }</pre></blockquote> * <p style="font-size:smaller;"> * <em>Discussion:</em> * These rules are designed as a dynamically-typed variation @@ -1144,7 +1144,7 @@ * a previous argument to {@code asVarargsCollector}. * <p> * Here is an example, of a list-making variable arity method handle: - * <blockquote><pre> + * <blockquote><pre>{@code MethodHandle asListVar = publicLookup() .findStatic(Arrays.class, "asList", methodType(List.class, Object[].class)) .asVarargsCollector(Object[].class); @@ -1163,7 +1163,7 @@ assertEquals("[three, thee, tee]", asListFix.invoke(argv).toString()); assertEquals(1, ((List) asListVar.invoke((Object)argv)).size()); assertEquals("[three, thee, tee]", asListFix.invoke((Object)argv).toString()); - * </pre></blockquote> + * }</pre></blockquote> * * @return a new method handle which accepts only a fixed number of arguments * @see #asVarargsCollector
--- a/src/share/classes/java/lang/invoke/MethodHandles.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/lang/invoke/MethodHandles.java Tue Jan 24 00:25:46 2017 +0000 @@ -1726,7 +1726,7 @@ * As in the case of {@link #dropArguments(MethodHandle,int,List) dropArguments}, * incoming arguments which are not mentioned in the reordering array * are may be any type, as determined only by {@code newType}. - * <blockquote><pre> + * <blockquote><pre>{@code import static java.lang.invoke.MethodHandles.*; import static java.lang.invoke.MethodType.*; ... @@ -1742,7 +1742,7 @@ MethodHandle twice = permuteArguments(add, intfn1, 0, 0); assert(twice.type().equals(intfn1)); assert((int)twice.invokeExact(21) == 42); - * </pre></blockquote> + * }</pre></blockquote> * @param target the method handle to invoke after arguments are reordered * @param newType the expected type of the new method handle * @param reorder an index array which controls the reordering
--- a/src/share/classes/java/lang/management/MemoryUsage.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/lang/management/MemoryUsage.java Tue Jan 24 00:25:46 2017 +0000 @@ -72,8 +72,8 @@ * The amount of used and committed memory will always be less than * or equal to <tt>max</tt> if <tt>max</tt> is defined. * A memory allocation may fail if it attempts to increase the - * used memory such that <tt>used > committed</tt> even - * if <tt>used <= max</tt> would still be true (for example, + * used memory such that <tt>used > committed</tt> even + * if <tt>used <= max</tt> would still be true (for example, * when the system is low on virtual memory). * </td> * </tr>
--- a/src/share/classes/java/lang/management/RuntimeMXBean.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/lang/management/RuntimeMXBean.java Tue Jan 24 00:25:46 2017 +0000 @@ -308,7 +308,7 @@ * * <p> * <b>MBeanServer access</b>:<br> - * The mapped type of <tt>Map<String,String></tt> is + * The mapped type of {@code Map<String,String>} is * {@link javax.management.openmbean.TabularData TabularData} * with two items in each row as follows: * <blockquote>
--- a/src/share/classes/java/lang/management/ThreadMXBean.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/lang/management/ThreadMXBean.java Tue Jan 24 00:25:46 2017 +0000 @@ -198,7 +198,7 @@ * <tt>null</tt> if the thread of the given ID is not alive or * it does not exist. * - * @throws IllegalArgumentException if <tt>id <= 0</tt>. + * @throws IllegalArgumentException if {@code id <= 0}. * @throws java.lang.SecurityException if a security manager * exists and the caller does not have * ManagementPermission("monitor"). @@ -236,7 +236,7 @@ * with no stack trace, no locked monitor and no synchronizer info. * * @throws IllegalArgumentException if any element in the input array - * <tt>ids</tt> is <tt><= 0</tt>. + * <tt>ids</tt> is {@code <= 0}. * @throws java.lang.SecurityException if a security manager * exists and the caller does not have * ManagementPermission("monitor"). @@ -282,7 +282,7 @@ * <tt>null</tt> if the thread of the given ID is not alive or * it does not exist. * - * @throws IllegalArgumentException if <tt>id <= 0</tt>. + * @throws IllegalArgumentException if {@code id <= 0}. * @throws IllegalArgumentException if <tt>maxDepth is negative</tt>. * @throws java.lang.SecurityException if a security manager * exists and the caller does not have @@ -336,7 +336,7 @@ * * @throws IllegalArgumentException if <tt>maxDepth is negative</tt>. * @throws IllegalArgumentException if any element in the input array - * <tt>ids</tt> is <tt><= 0</tt>. + * <tt>ids</tt> is {@code <= 0}. * @throws java.lang.SecurityException if a security manager * exists and the caller does not have * ManagementPermission("monitor"). @@ -466,7 +466,7 @@ * and CPU time measurement is enabled; * <tt>-1</tt> otherwise. * - * @throws IllegalArgumentException if <tt>id <= 0 </tt>. + * @throws IllegalArgumentException if {@code id <= 0}. * @throws java.lang.UnsupportedOperationException if the Java * virtual machine does not support CPU time measurement for * other threads. @@ -501,7 +501,7 @@ * and CPU time measurement is enabled; * <tt>-1</tt> otherwise. * - * @throws IllegalArgumentException if <tt>id <= 0 </tt>. + * @throws IllegalArgumentException if {@code id <= 0}. * @throws java.lang.UnsupportedOperationException if the Java * virtual machine does not support CPU time measurement for * other threads.
--- a/src/share/classes/java/net/CookieManager.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/net/CookieManager.java Tue Jan 24 00:25:46 2017 +0000 @@ -41,7 +41,7 @@ * * <p> The HTTP cookie management in java.net package looks like: * <blockquote> - * <pre> + * <pre>{@code * use * CookieHandler <------- HttpURLConnection * ^ @@ -58,7 +58,7 @@ * | impl * | * Internal in-memory implementation - * </pre> + * }</pre> * <ul> * <li> * CookieHandler is at the core of cookie management. User can call
--- a/src/share/classes/java/net/CookiePolicy.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/net/CookiePolicy.java Tue Jan 24 00:25:46 2017 +0000 @@ -30,7 +30,7 @@ * and which should be rejected. Three pre-defined policy implementations * are provided, namely ACCEPT_ALL, ACCEPT_NONE and ACCEPT_ORIGINAL_SERVER. * - * <p>See RFC 2965 sec. 3.3 & 7 for more detail. + * <p>See RFC 2965 sec. 3.3 and 7 for more detail. * * @author Edward Wang * @since 1.6
--- a/src/share/classes/java/net/DatagramSocket.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/net/DatagramSocket.java Tue Jan 24 00:25:46 2017 +0000 @@ -358,12 +358,12 @@ } /** - * Binds this DatagramSocket to a specific address & port. + * Binds this DatagramSocket to a specific address and port. * <p> * If the address is <code>null</code>, then the system will pick up * an ephemeral port and a valid local address to bind the socket. *<p> - * @param addr The address & port to bind to. + * @param addr The address and port to bind to. * @throws SocketException if any error happens during the bind, or if the * socket is already bound. * @throws SecurityException if a security manager exists and its @@ -892,7 +892,7 @@ * a <B>java.net.SocketTimeoutException</B> is raised, though the * DatagramSocket is still valid. The option <B>must</B> be enabled * prior to entering the blocking operation to have effect. The - * timeout must be > 0. + * timeout must be {@code > 0}. * A timeout of zero is interpreted as an infinite timeout. * * @param timeout the specified timeout in milliseconds. @@ -1149,8 +1149,8 @@ * As the underlying network implementation may ignore this * value applications should consider it a hint. * - * <P> The tc <B>must</B> be in the range <code> 0 <= tc <= - * 255</code> or an IllegalArgumentException will be thrown. + * <P> The tc <B>must</B> be in the range {@code 0 <= tc <= + * 255} or an IllegalArgumentException will be thrown. * <p>Notes: * <p>For Internet Protocol v4 the value consists of an * <code>integer</code>, the least significant 8 bits of which
--- a/src/share/classes/java/net/HttpURLConnection.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/net/HttpURLConnection.java Tue Jan 24 00:25:46 2017 +0000 @@ -97,7 +97,7 @@ * server. In this case, {@link #getHeaderField(int) getHeaderField(0)} returns the status * line, but <code>getHeaderFieldKey(0)</code> returns null. * - * @param n an index, where n >=0. + * @param n an index, where {@code n >=0}. * @return the key for the <code>n</code><sup>th</sup> header field, * or <code>null</code> if the key does not exist. */ @@ -248,7 +248,7 @@ * {@link #getHeaderFieldKey getHeaderFieldKey} method to iterate through all * the headers in the message. * - * @param n an index, where n>=0. + * @param n an index, where {@code n>=0}. * @return the value of the <code>n</code><sup>th</sup> header field, * or <code>null</code> if the value does not exist. * @see java.net.HttpURLConnection#getHeaderFieldKey(int)
--- a/src/share/classes/java/net/InetSocketAddress.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/net/InetSocketAddress.java Tue Jan 24 00:25:46 2017 +0000 @@ -389,7 +389,7 @@ * Two instances of <code>InetSocketAddress</code> represent the same * address if both the InetAddresses (or hostnames if it is unresolved) and port * numbers are equal. - * If both addresses are unresolved, then the hostname & the port number + * If both addresses are unresolved, then the hostname and the port number * are compared. * * Note: Hostnames are case insensitive. e.g. "FooBar" and "foobar" are
--- a/src/share/classes/java/net/MulticastSocket.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/net/MulticastSocket.java Tue Jan 24 00:25:46 2017 +0000 @@ -196,7 +196,7 @@ * scope of the multicasts. * * <p>The ttl is an <b>unsigned</b> 8-bit quantity, and so <B>must</B> be - * in the range <code> 0 <= ttl <= 0xFF </code>. + * in the range {@code 0 <= ttl <= 0xFF }. * * @param ttl the time-to-live * @exception IOException if an I/O exception occurs
--- a/src/share/classes/java/net/ServerSocket.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/net/ServerSocket.java Tue Jan 24 00:25:46 2017 +0000 @@ -317,7 +317,7 @@ * If the address is <code>null</code>, then the system will pick up * an ephemeral port and a valid local address to bind the socket. * <p> - * @param endpoint The IP address & port number to bind to. + * @param endpoint The IP address and port number to bind to. * @throws IOException if the bind operation fails, or if the socket * is already bound. * @throws SecurityException if a <code>SecurityManager</code> is present and @@ -344,7 +344,7 @@ * or may choose to ignore the parameter altogther. The value provided * should be greater than <code>0</code>. If it is less than or equal to * <code>0</code>, then an implementation specific default will be used. - * @param endpoint The IP address & port number to bind to. + * @param endpoint The IP address and port number to bind to. * @param backlog requested maximum length of the queue of * incoming connections. * @throws IOException if the bind operation fails, or if the socket @@ -623,7 +623,7 @@ * a <B>java.net.SocketTimeoutException</B> is raised, though the * ServerSocket is still valid. The option <B>must</B> be enabled * prior to entering the blocking operation to have effect. The - * timeout must be > 0. + * timeout must be {@code > 0}. * A timeout of zero is interpreted as an infinite timeout. * @param timeout the specified timeout, in milliseconds * @exception SocketException if there is an error in
--- a/src/share/classes/java/net/Socket.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/net/Socket.java Tue Jan 24 00:25:46 2017 +0000 @@ -1085,7 +1085,7 @@ * a <B>java.net.SocketTimeoutException</B> is raised, though the * Socket is still valid. The option <B>must</B> be enabled * prior to entering the blocking operation to have effect. The - * timeout must be > 0. + * timeout must be {@code > 0}. * A timeout of zero is interpreted as an infinite timeout. * @param timeout the specified timeout, in milliseconds. * @exception SocketException if there is an error @@ -1286,8 +1286,8 @@ * As the underlying network implementation may ignore this * value applications should consider it a hint. * - * <P> The tc <B>must</B> be in the range <code> 0 <= tc <= - * 255</code> or an IllegalArgumentException will be thrown. + * <P> The tc <B>must</B> be in the range {@code 0 <= tc <= + * 255} or an IllegalArgumentException will be thrown. * <p>Notes: * <p>For Internet Protocol v4 the value consists of an * <code>integer</code>, the least significant 8 bits of which
--- a/src/share/classes/java/net/StandardSocketOptions.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/net/StandardSocketOptions.java Tue Jan 24 00:25:46 2017 +0000 @@ -277,8 +277,8 @@ * The <em>time-to-live</em> for Internet Protocol (IP) multicast datagrams. * * <p> The value of this socket option is an {@code Integer} in the range - * <tt>0 <= value <= 255</tt>. It is used to control - * the scope of multicast datagrams sent by the datagram-oriented socket. + * {@code 0 <= value <= 255}. It is used to control the scope of multicast + * datagrams sent by the datagram-oriented socket. * In the case of an {@link StandardProtocolFamily#INET IPv4} socket * the option is the time-to-live (TTL) on multicast datagrams sent by the * socket. Datagrams with a TTL of zero are not transmitted on the network
--- a/src/share/classes/java/net/URI.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/net/URI.java Tue Jan 24 00:25:46 2017 +0000 @@ -258,7 +258,7 @@ * <td>All <i>alphanum</i> characters together with those in the string * <tt>"_-!.~'()*"</tt></td></tr> * <tr><th valign=top><i>punct</i></th> - * <td>The characters in the string <tt>",;:$&+="</tt></td></tr> + * <td>The characters in the string <tt>",;:$&+="</tt></td></tr> * <tr><th valign=top><i>reserved</i></th> * <td>All <i>punct</i> characters together with those in the string * <tt>"?/[]@"</tt></td></tr>
--- a/src/share/classes/java/net/URLConnection.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/net/URLConnection.java Tue Jan 24 00:25:46 2017 +0000 @@ -672,7 +672,7 @@ * Returns the key for the <code>n</code><sup>th</sup> header field. * It returns <code>null</code> if there are fewer than <code>n+1</code> fields. * - * @param n an index, where n>=0 + * @param n an index, where {@code n>=0} * @return the key for the <code>n</code><sup>th</sup> header field, * or <code>null</code> if there are fewer than <code>n+1</code> * fields. @@ -690,7 +690,7 @@ * {@link #getHeaderFieldKey(int) getHeaderFieldKey} method to iterate through all * the headers in the message. * - * @param n an index, where n>=0 + * @param n an index, where {@code n>=0} * @return the value of the <code>n</code><sup>th</sup> header field * or <code>null</code> if there are fewer than <code>n+1</code> fields * @see java.net.URLConnection#getHeaderFieldKey(int)
--- a/src/share/classes/java/nio/X-Buffer.java.template Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/nio/X-Buffer.java.template Tue Jan 24 00:25:46 2017 +0000 @@ -634,9 +634,10 @@ * <tt>src.get(dst, off, len)</tt> has exactly the same effect as * the loop * - * <pre> + * <pre>{@code * for (int i = off; i < off + len; i++) - * dst[i] = src.get(); </pre> + * dst[i] = src.get(): + * }</pre> * * except that it first checks that there are sufficient $type$s in * this buffer and it is potentially much more efficient. </p> @@ -768,9 +769,10 @@ * <tt>dst.put(src, off, len)</tt> has exactly the same effect as * the loop * - * <pre> + * <pre>{@code * for (int i = off; i < off + len; i++) - * dst.put(a[i]); </pre> + * dst.put(a[i]); + * }</pre> * * except that it first checks that there is sufficient space in this * buffer and it is potentially much more efficient. </p> @@ -854,9 +856,10 @@ * <tt>dst.put(src, start, end)</tt> has exactly the same effect * as the loop * - * <pre> + * <pre>{@code * for (int i = start; i < end; i++) - * dst.put(src.charAt(i)); </pre> + * dst.put(src.charAt(i)); + * }</pre> * * except that it first checks that there is sufficient space in this * buffer and it is potentially much more efficient. </p> @@ -1014,12 +1017,13 @@ * write was incomplete. The following loop, for example, copies bytes * from one channel to another via the buffer <tt>buf</tt>: * - * <blockquote><pre> - * buf.clear(); // Prepare buffer for use - * while (in.read(buf) >= 0 || buf.position != 0) { - * buf.flip(); - * out.write(buf); - * buf.compact(); // In case of partial write + * <blockquote><pre>{@code + * buf.clear(); // Prepare buffer for use + * while (in.read(buf) >= 0 || buf.position != 0) { + * buf.flip(); + * out.write(buf); + * buf.compact(); // In case of partial write + * } * }</pre></blockquote> * #end[byte]
--- a/src/share/classes/java/nio/channels/SelectableChannel.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/nio/channels/SelectableChannel.java Tue Jan 24 00:25:46 2017 +0000 @@ -208,7 +208,7 @@ * @throws IllegalArgumentException * If a bit in the <tt>ops</tt> set does not correspond to an * operation that is supported by this channel, that is, if - * <tt>set & ~validOps() != 0</tt> + * {@code set & ~validOps() != 0} * * @return A key representing the registration of this channel with * the given selector @@ -265,8 +265,8 @@ * * @throws IllegalArgumentException * If a bit in <tt>ops</tt> does not correspond to an operation - * that is supported by this channel, that is, if <tt>set & - * ~validOps() != 0</tt> + * that is supported by this channel, that is, if {@code set & + * ~validOps() != 0} * * @return A key representing the registration of this channel with * the given selector
--- a/src/share/classes/java/nio/channels/SelectionKey.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/nio/channels/SelectionKey.java Tue Jan 24 00:25:46 2017 +0000 @@ -191,7 +191,7 @@ * @throws IllegalArgumentException * If a bit in the set does not correspond to an operation that * is supported by this key's channel, that is, if - * <tt>(ops & ~channel().validOps()) != 0</tt> + * {@code (ops & ~channel().validOps()) != 0} * * @throws CancelledKeyException * If this key has been cancelled @@ -272,15 +272,15 @@ * <p> An invocation of this method of the form <tt>k.isReadable()</tt> * behaves in exactly the same way as the expression * - * <blockquote><pre> - * k.readyOps() & OP_READ != 0</pre></blockquote> + * <blockquote><pre>{@code + * k.readyOps() & OP_READ != 0 + * }</pre></blockquote> * * <p> If this key's channel does not support read operations then this * method always returns <tt>false</tt>. </p> * * @return <tt>true</tt> if, and only if, - * <tt>readyOps()</tt> <tt>&</tt> <tt>OP_READ</tt> is - * nonzero + {@code readyOps() & OP_READ} is nonzero * * @throws CancelledKeyException * If this key has been cancelled @@ -295,15 +295,15 @@ * <p> An invocation of this method of the form <tt>k.isWritable()</tt> * behaves in exactly the same way as the expression * - * <blockquote><pre> - * k.readyOps() & OP_WRITE != 0</pre></blockquote> + * <blockquote><pre>{@code + * k.readyOps() & OP_WRITE != 0 + * }</pre></blockquote> * * <p> If this key's channel does not support write operations then this * method always returns <tt>false</tt>. </p> * * @return <tt>true</tt> if, and only if, - * <tt>readyOps()</tt> <tt>&</tt> <tt>OP_WRITE</tt> - * is nonzero + * {@code readyOps() & OP_WRITE} is nonzero * * @throws CancelledKeyException * If this key has been cancelled @@ -319,15 +319,15 @@ * <p> An invocation of this method of the form <tt>k.isConnectable()</tt> * behaves in exactly the same way as the expression * - * <blockquote><pre> - * k.readyOps() & OP_CONNECT != 0</pre></blockquote> + * <blockqoute><pre>{@code + * k.readyOps() & OP_CONNECT != 0 + * }</pre></blockquote> * * <p> If this key's channel does not support socket-connect operations * then this method always returns <tt>false</tt>. </p> * * @return <tt>true</tt> if, and only if, - * <tt>readyOps()</tt> <tt>&</tt> <tt>OP_CONNECT</tt> - * is nonzero + * {@code readyOps() & OP_CONNECT} is nonzero * * @throws CancelledKeyException * If this key has been cancelled @@ -343,15 +343,15 @@ * <p> An invocation of this method of the form <tt>k.isAcceptable()</tt> * behaves in exactly the same way as the expression * - * <blockquote><pre> - * k.readyOps() & OP_ACCEPT != 0</pre></blockquote> + * <blockquote><pre>{@code + * k.readyOps() & OP_ACCEPT != 0 + * }</pre></blockquote> * * <p> If this key's channel does not support socket-accept operations then * this method always returns <tt>false</tt>. </p> * * @return <tt>true</tt> if, and only if, - * <tt>readyOps()</tt> <tt>&</tt> <tt>OP_ACCEPT</tt> - * is nonzero + * {@code readyOps() & OP_ACCEPT} is nonzero * * @throws CancelledKeyException * If this key has been cancelled
--- a/src/share/classes/java/nio/charset/Charset-X-Coder.java.template Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/nio/charset/Charset-X-Coder.java.template Tue Jan 24 00:25:46 2017 +0000 @@ -254,7 +254,7 @@ * method, passing the new replacement, after checking that the new * replacement is acceptable. </p> * - * @param newReplacement + * @param newReplacement The replacement value * #if[decoder] * The new replacement; must not be <tt>null</tt> @@ -296,7 +296,7 @@ * should be overridden by $coder$s that require notification of changes to * the replacement. </p> * - * @param newReplacement + * @param newReplacement The replacement value */ protected void implReplaceWith($replType$ newReplacement) { }
--- a/src/share/classes/java/nio/file/Path.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/nio/file/Path.java Tue Jan 24 00:25:46 2017 +0000 @@ -64,7 +64,7 @@ * those developing custom file system implementations. Methods may be added to * this interface in future releases. </p> * - * <a name="interop"><h4>Accessing Files</h4></a> + * <h4>Accessing Files</h4> * <p> Paths may be used with the {@link Files} class to operate on files, * directories, and other types of files. For example, suppose we want a {@link * java.io.BufferedReader} to read text from a file "{@code access.log}". The @@ -87,7 +87,7 @@ * addition, the {@link #toFile toFile} method is useful to construct a {@code * File} from the {@code String} representation of a {@code Path}. * - * <h4>Concurrency</h4></a> + * <h4>Concurrency</h4> * <p> Implementations of this interface are immutable and safe for use by * multiple concurrent threads. *
--- a/src/share/classes/java/security/SecureRandom.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/security/SecureRandom.java Tue Jan 24 00:25:46 2017 +0000 @@ -475,7 +475,7 @@ * <code>nextLong</code>, and <code>nextFloat</code>). * * @param numBits number of pseudo-random bits to be generated, where - * 0 <= <code>numBits</code> <= 32. + * {@code 0 <= numBits <= 32}. * * @return an <code>int</code> containing the user-specified number * of pseudo-random bits (right justified, with leading zeros).
--- a/src/share/classes/java/security/cert/CertPathValidatorException.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/security/cert/CertPathValidatorException.java Tue Jan 24 00:25:46 2017 +0000 @@ -141,8 +141,8 @@ * that caused the error (or -1 if not applicable). Note that * the list of certificates in a <code>CertPath</code> is zero based. * @throws IndexOutOfBoundsException if the index is out of range - * <code>(index < -1 || (certPath != null && index >= - * certPath.getCertificates().size())</code> + * {@code (index < -1 || (certPath != null && index >= + * certPath.getCertificates().size()) } * @throws IllegalArgumentException if <code>certPath</code> is * <code>null</code> and <code>index</code> is not -1 */ @@ -164,8 +164,8 @@ * the list of certificates in a <code>CertPath</code> is zero based. * @param reason the reason the validation failed * @throws IndexOutOfBoundsException if the index is out of range - * <code>(index < -1 || (certPath != null && index >= - * certPath.getCertificates().size())</code> + * {@code (index < -1 || (certPath != null && index >= + * certPath.getCertificates().size()) } * @throws IllegalArgumentException if <code>certPath</code> is * <code>null</code> and <code>index</code> is not -1 * @throws NullPointerException if <code>reason</code> is <code>null</code>
--- a/src/share/classes/java/security/cert/CertificateFactory.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/security/cert/CertificateFactory.java Tue Jan 24 00:25:46 2017 +0000 @@ -65,7 +65,7 @@ * read position of the input stream is positioned to the next certificate in * the file:<p> * - * <pre> + * <pre>{@code * FileInputStream fis = new FileInputStream(filename); * BufferedInputStream bis = new BufferedInputStream(fis); * @@ -75,7 +75,7 @@ * Certificate cert = cf.generateCertificate(bis); * System.out.println(cert.toString()); * } - * </pre> + * }</pre> * * <p>The following example parses a PKCS#7-formatted certificate reply stored * in a file and extracts all the certificates from it:<p>
--- a/src/share/classes/java/security/cert/X509Extension.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/security/cert/X509Extension.java Tue Jan 24 00:25:46 2017 +0000 @@ -84,12 +84,12 @@ * * Here is sample code to get a Set of critical extensions from an * X509Certificate and print the OIDs: - * <pre><code> + * <pre>{@code * X509Certificate cert = null; * try (InputStream inStrm = new FileInputStream("DER-encoded-Cert")) { * CertificateFactory cf = CertificateFactory.getInstance("X.509"); * cert = (X509Certificate)cf.generateCertificate(inStrm); - * }<p> + * } * * Set<String> critSet = cert.getCriticalExtensionOIDs(); * if (critSet != null && !critSet.isEmpty()) { @@ -98,7 +98,7 @@ * System.out.println(oid); * } * } - * </code></pre> + * }</pre> * @return a Set (or an empty Set if none are marked critical) of * the extension OID strings for extensions that are marked critical. * If there are no extensions present at all, then this method returns
--- a/src/share/classes/java/security/spec/EllipticCurve.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/security/spec/EllipticCurve.java Tue Jan 24 00:25:46 2017 +0000 @@ -184,9 +184,9 @@ * Returns a hash code value for this elliptic curve. * @return a hash code value computed from the hash codes of the field, A, * and B, as follows: - * <code> + * <pre>{@code * (field.hashCode() << 6) + (a.hashCode() << 4) + (b.hashCode() << 2) - * </code> + * }</pre> */ public int hashCode() { return (field.hashCode() << 6 +
--- a/src/share/classes/java/sql/DatabaseMetaData.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/sql/DatabaseMetaData.java Tue Jan 24 00:25:46 2017 +0000 @@ -1218,21 +1218,21 @@ * * <P>Each procedure description has the the following columns: * <OL> - * <LI><B>PROCEDURE_CAT</B> String => procedure catalog (may be <code>null</code>) - * <LI><B>PROCEDURE_SCHEM</B> String => procedure schema (may be <code>null</code>) - * <LI><B>PROCEDURE_NAME</B> String => procedure name + * <LI><B>PROCEDURE_CAT</B> String {@code =>} procedure catalog (may be <code>null</code>) + * <LI><B>PROCEDURE_SCHEM</B> String {@code =>} procedure schema (may be <code>null</code>) + * <LI><B>PROCEDURE_NAME</B> String {@code =>} procedure name * <LI> reserved for future use * <LI> reserved for future use * <LI> reserved for future use - * <LI><B>REMARKS</B> String => explanatory comment on the procedure - * <LI><B>PROCEDURE_TYPE</B> short => kind of procedure: + * <LI><B>REMARKS</B> String {@code =>} explanatory comment on the procedure + * <LI><B>PROCEDURE_TYPE</B> short {@code =>} kind of procedure: * <UL> * <LI> procedureResultUnknown - Cannot determine if a return value * will be returned * <LI> procedureNoResult - Does not return a return value * <LI> procedureReturnsResult - Returns a return value * </UL> - * <LI><B>SPECIFIC_NAME</B> String => The name which uniquely identifies this + * <LI><B>SPECIFIC_NAME</B> String {@code =>} The name which uniquely identifies this * procedure within its schema. * </OL> * <p> @@ -1297,11 +1297,11 @@ * <P>Each row in the <code>ResultSet</code> is a parameter description or * column description with the following fields: * <OL> - * <LI><B>PROCEDURE_CAT</B> String => procedure catalog (may be <code>null</code>) - * <LI><B>PROCEDURE_SCHEM</B> String => procedure schema (may be <code>null</code>) - * <LI><B>PROCEDURE_NAME</B> String => procedure name - * <LI><B>COLUMN_NAME</B> String => column/parameter name - * <LI><B>COLUMN_TYPE</B> Short => kind of column/parameter: + * <LI><B>PROCEDURE_CAT</B> String {@code =>} procedure catalog (may be <code>null</code>) + * <LI><B>PROCEDURE_SCHEM</B> String {@code =>} procedure schema (may be <code>null</code>) + * <LI><B>PROCEDURE_NAME</B> String {@code =>} procedure name + * <LI><B>COLUMN_NAME</B> String {@code =>} column/parameter name + * <LI><B>COLUMN_TYPE</B> Short {@code =>} kind of column/parameter: * <UL> * <LI> procedureColumnUnknown - nobody knows * <LI> procedureColumnIn - IN parameter @@ -1310,44 +1310,44 @@ * <LI> procedureColumnReturn - procedure return value * <LI> procedureColumnResult - result column in <code>ResultSet</code> * </UL> - * <LI><B>DATA_TYPE</B> int => SQL type from java.sql.Types - * <LI><B>TYPE_NAME</B> String => SQL type name, for a UDT type the + * <LI><B>DATA_TYPE</B> int {@code =>} SQL type from java.sql.Types + * <LI><B>TYPE_NAME</B> String {@code =>} SQL type name, for a UDT type the * type name is fully qualified - * <LI><B>PRECISION</B> int => precision - * <LI><B>LENGTH</B> int => length in bytes of data - * <LI><B>SCALE</B> short => scale - null is returned for data types where + * <LI><B>PRECISION</B> int {@code =>} precision + * <LI><B>LENGTH</B> int {@code =>} length in bytes of data + * <LI><B>SCALE</B> short {@code =>} scale - null is returned for data types where * SCALE is not applicable. - * <LI><B>RADIX</B> short => radix - * <LI><B>NULLABLE</B> short => can it contain NULL. + * <LI><B>RADIX</B> short {@code =>} radix + * <LI><B>NULLABLE</B> short {@code =>} can it contain NULL. * <UL> * <LI> procedureNoNulls - does not allow NULL values * <LI> procedureNullable - allows NULL values * <LI> procedureNullableUnknown - nullability unknown * </UL> - * <LI><B>REMARKS</B> String => comment describing parameter/column - * <LI><B>COLUMN_DEF</B> String => default value for the column, which should be interpreted as a string when the value is enclosed in single quotes (may be <code>null</code>) + * <LI><B>REMARKS</B> String {@code =>} comment describing parameter/column + * <LI><B>COLUMN_DEF</B> String {@code =>} default value for the column, which should be interpreted as a string when the value is enclosed in single quotes (may be <code>null</code>) * <UL> * <LI> The string NULL (not enclosed in quotes) - if NULL was specified as the default value * <LI> TRUNCATE (not enclosed in quotes) - if the specified default value cannot be represented without truncation * <LI> NULL - if a default value was not specified * </UL> - * <LI><B>SQL_DATA_TYPE</B> int => reserved for future use - * <LI><B>SQL_DATETIME_SUB</B> int => reserved for future use - * <LI><B>CHAR_OCTET_LENGTH</B> int => the maximum length of binary and character based columns. For any other datatype the returned value is a + * <LI><B>SQL_DATA_TYPE</B> int {@code =>} reserved for future use + * <LI><B>SQL_DATETIME_SUB</B> int {@code =>} reserved for future use + * <LI><B>CHAR_OCTET_LENGTH</B> int {@code =>} the maximum length of binary and character based columns. For any other datatype the returned value is a * NULL - * <LI><B>ORDINAL_POSITION</B> int => the ordinal position, starting from 1, for the input and output parameters for a procedure. A value of 0 + * <LI><B>ORDINAL_POSITION</B> int {@code =>} the ordinal position, starting from 1, for the input and output parameters for a procedure. A value of 0 *is returned if this row describes the procedure's return value. For result set columns, it is the *ordinal position of the column in the result set starting from 1. If there are *multiple result sets, the column ordinal positions are implementation * defined. - * <LI><B>IS_NULLABLE</B> String => ISO rules are used to determine the nullability for a column. + * <LI><B>IS_NULLABLE</B> String {@code =>} ISO rules are used to determine the nullability for a column. * <UL> * <LI> YES --- if the column can include NULLs * <LI> NO --- if the column cannot include NULLs * <LI> empty string --- if the nullability for the * column is unknown * </UL> - * <LI><B>SPECIFIC_NAME</B> String => the name which uniquely identifies this procedure within its schema. + * <LI><B>SPECIFIC_NAME</B> String {@code =>} the name which uniquely identifies this procedure within its schema. * </OL> * * <P><B>Note:</B> Some databases may not return the column @@ -1481,19 +1481,19 @@ * <P> * Each table description has the following columns: * <OL> - * <LI><B>TABLE_CAT</B> String => table catalog (may be <code>null</code>) - * <LI><B>TABLE_SCHEM</B> String => table schema (may be <code>null</code>) - * <LI><B>TABLE_NAME</B> String => table name - * <LI><B>TABLE_TYPE</B> String => table type. Typical types are "TABLE", + * <LI><B>TABLE_CAT</B> String {@code =>} table catalog (may be <code>null</code>) + * <LI><B>TABLE_SCHEM</B> String {@code =>} table schema (may be <code>null</code>) + * <LI><B>TABLE_NAME</B> String {@code =>} table name + * <LI><B>TABLE_TYPE</B> String {@code =>} table type. Typical types are "TABLE", * "VIEW", "SYSTEM TABLE", "GLOBAL TEMPORARY", * "LOCAL TEMPORARY", "ALIAS", "SYNONYM". - * <LI><B>REMARKS</B> String => explanatory comment on the table - * <LI><B>TYPE_CAT</B> String => the types catalog (may be <code>null</code>) - * <LI><B>TYPE_SCHEM</B> String => the types schema (may be <code>null</code>) - * <LI><B>TYPE_NAME</B> String => type name (may be <code>null</code>) - * <LI><B>SELF_REFERENCING_COL_NAME</B> String => name of the designated + * <LI><B>REMARKS</B> String {@code =>} explanatory comment on the table + * <LI><B>TYPE_CAT</B> String {@code =>} the types catalog (may be <code>null</code>) + * <LI><B>TYPE_SCHEM</B> String {@code =>} the types schema (may be <code>null</code>) + * <LI><B>TYPE_NAME</B> String {@code =>} type name (may be <code>null</code>) + * <LI><B>SELF_REFERENCING_COL_NAME</B> String {@code =>} name of the designated * "identifier" column of a typed table (may be <code>null</code>) - * <LI><B>REF_GENERATION</B> String => specifies how values in + * <LI><B>REF_GENERATION</B> String {@code =>} specifies how values in * SELF_REFERENCING_COL_NAME are created. Values are * "SYSTEM", "USER", "DERIVED". (may be <code>null</code>) * </OL> @@ -1528,8 +1528,8 @@ * * <P>The schema columns are: * <OL> - * <LI><B>TABLE_SCHEM</B> String => schema name - * <LI><B>TABLE_CATALOG</B> String => catalog name (may be <code>null</code>) + * <LI><B>TABLE_SCHEM</B> String {@code =>} schema name + * <LI><B>TABLE_CATALOG</B> String {@code =>} catalog name (may be <code>null</code>) * </OL> * * @return a <code>ResultSet</code> object in which each row is a @@ -1545,7 +1545,7 @@ * * <P>The catalog column is: * <OL> - * <LI><B>TABLE_CAT</B> String => catalog name + * <LI><B>TABLE_CAT</B> String {@code =>} catalog name * </OL> * * @return a <code>ResultSet</code> object in which each row has a @@ -1560,7 +1560,7 @@ * * <P>The table type is: * <OL> - * <LI><B>TABLE_TYPE</B> String => table type. Typical types are "TABLE", + * <LI><B>TABLE_TYPE</B> String {@code =>} table type. Typical types are "TABLE", * "VIEW", "SYSTEM TABLE", "GLOBAL TEMPORARY", * "LOCAL TEMPORARY", "ALIAS", "SYNONYM". * </OL> @@ -1582,55 +1582,55 @@ * * <P>Each column description has the following columns: * <OL> - * <LI><B>TABLE_CAT</B> String => table catalog (may be <code>null</code>) - * <LI><B>TABLE_SCHEM</B> String => table schema (may be <code>null</code>) - * <LI><B>TABLE_NAME</B> String => table name - * <LI><B>COLUMN_NAME</B> String => column name - * <LI><B>DATA_TYPE</B> int => SQL type from java.sql.Types - * <LI><B>TYPE_NAME</B> String => Data source dependent type name, + * <LI><B>TABLE_CAT</B> String {@code =>} table catalog (may be <code>null</code>) + * <LI><B>TABLE_SCHEM</B> String {@code =>} table schema (may be <code>null</code>) + * <LI><B>TABLE_NAME</B> String {@code =>} table name + * <LI><B>COLUMN_NAME</B> String {@code =>} column name + * <LI><B>DATA_TYPE</B> int {@code =>} SQL type from java.sql.Types + * <LI><B>TYPE_NAME</B> String {@code =>} Data source dependent type name, * for a UDT the type name is fully qualified - * <LI><B>COLUMN_SIZE</B> int => column size. + * <LI><B>COLUMN_SIZE</B> int {@code =>} column size. * <LI><B>BUFFER_LENGTH</B> is not used. - * <LI><B>DECIMAL_DIGITS</B> int => the number of fractional digits. Null is returned for data types where + * <LI><B>DECIMAL_DIGITS</B> int {@code =>} the number of fractional digits. Null is returned for data types where * DECIMAL_DIGITS is not applicable. - * <LI><B>NUM_PREC_RADIX</B> int => Radix (typically either 10 or 2) - * <LI><B>NULLABLE</B> int => is NULL allowed. + * <LI><B>NUM_PREC_RADIX</B> int {@code =>} Radix (typically either 10 or 2) + * <LI><B>NULLABLE</B> int {@code =>} is NULL allowed. * <UL> * <LI> columnNoNulls - might not allow <code>NULL</code> values * <LI> columnNullable - definitely allows <code>NULL</code> values * <LI> columnNullableUnknown - nullability unknown * </UL> - * <LI><B>REMARKS</B> String => comment describing column (may be <code>null</code>) - * <LI><B>COLUMN_DEF</B> String => default value for the column, which should be interpreted as a string when the value is enclosed in single quotes (may be <code>null</code>) - * <LI><B>SQL_DATA_TYPE</B> int => unused - * <LI><B>SQL_DATETIME_SUB</B> int => unused - * <LI><B>CHAR_OCTET_LENGTH</B> int => for char types the + * <LI><B>REMARKS</B> String {@code =>} comment describing column (may be <code>null</code>) + * <LI><B>COLUMN_DEF</B> String {@code =>} default value for the column, which should be interpreted as a string when the value is enclosed in single quotes (may be <code>null</code>) + * <LI><B>SQL_DATA_TYPE</B> int {@code =>} unused + * <LI><B>SQL_DATETIME_SUB</B> int {@code =>} unused + * <LI><B>CHAR_OCTET_LENGTH</B> int {@code =>} for char types the * maximum number of bytes in the column - * <LI><B>ORDINAL_POSITION</B> int => index of column in table + * <LI><B>ORDINAL_POSITION</B> int {@code =>} index of column in table * (starting at 1) - * <LI><B>IS_NULLABLE</B> String => ISO rules are used to determine the nullability for a column. + * <LI><B>IS_NULLABLE</B> String {@code =>} ISO rules are used to determine the nullability for a column. * <UL> * <LI> YES --- if the column can include NULLs * <LI> NO --- if the column cannot include NULLs * <LI> empty string --- if the nullability for the * column is unknown * </UL> - * <LI><B>SCOPE_CATALOG</B> String => catalog of table that is the scope + * <LI><B>SCOPE_CATALOG</B> String {@code =>} catalog of table that is the scope * of a reference attribute (<code>null</code> if DATA_TYPE isn't REF) - * <LI><B>SCOPE_SCHEMA</B> String => schema of table that is the scope + * <LI><B>SCOPE_SCHEMA</B> String {@code =>} schema of table that is the scope * of a reference attribute (<code>null</code> if the DATA_TYPE isn't REF) - * <LI><B>SCOPE_TABLE</B> String => table name that this the scope + * <LI><B>SCOPE_TABLE</B> String {@code =>} table name that this the scope * of a reference attribute (<code>null</code> if the DATA_TYPE isn't REF) - * <LI><B>SOURCE_DATA_TYPE</B> short => source type of a distinct type or user-generated + * <LI><B>SOURCE_DATA_TYPE</B> short {@code =>} source type of a distinct type or user-generated * Ref type, SQL type from java.sql.Types (<code>null</code> if DATA_TYPE * isn't DISTINCT or user-generated REF) - * <LI><B>IS_AUTOINCREMENT</B> String => Indicates whether this column is auto incremented + * <LI><B>IS_AUTOINCREMENT</B> String {@code =>} Indicates whether this column is auto incremented * <UL> * <LI> YES --- if the column is auto incremented * <LI> NO --- if the column is not auto incremented * <LI> empty string --- if it cannot be determined whether the column is auto incremented * </UL> - * <LI><B>IS_GENERATEDCOLUMN</B> String => Indicates whether this is a generated column + * <LI><B>IS_GENERATEDCOLUMN</B> String {@code =>} Indicates whether this is a generated column * <UL> * <LI> YES --- if this a generated column * <LI> NO --- if this not a generated column @@ -1703,15 +1703,15 @@ * * <P>Each privilige description has the following columns: * <OL> - * <LI><B>TABLE_CAT</B> String => table catalog (may be <code>null</code>) - * <LI><B>TABLE_SCHEM</B> String => table schema (may be <code>null</code>) - * <LI><B>TABLE_NAME</B> String => table name - * <LI><B>COLUMN_NAME</B> String => column name - * <LI><B>GRANTOR</B> String => grantor of access (may be <code>null</code>) - * <LI><B>GRANTEE</B> String => grantee of access - * <LI><B>PRIVILEGE</B> String => name of access (SELECT, + * <LI><B>TABLE_CAT</B> String {@code =>} table catalog (may be <code>null</code>) + * <LI><B>TABLE_SCHEM</B> String {@code =>} table schema (may be <code>null</code>) + * <LI><B>TABLE_NAME</B> String {@code =>} table name + * <LI><B>COLUMN_NAME</B> String {@code =>} column name + * <LI><B>GRANTOR</B> String {@code =>} grantor of access (may be <code>null</code>) + * <LI><B>GRANTEE</B> String {@code =>} grantee of access + * <LI><B>PRIVILEGE</B> String {@code =>} name of access (SELECT, * INSERT, UPDATE, REFRENCES, ...) - * <LI><B>IS_GRANTABLE</B> String => "YES" if grantee is permitted + * <LI><B>IS_GRANTABLE</B> String {@code =>} "YES" if grantee is permitted * to grant to others; "NO" if not; <code>null</code> if unknown * </OL> * @@ -1749,14 +1749,14 @@ * * <P>Each privilige description has the following columns: * <OL> - * <LI><B>TABLE_CAT</B> String => table catalog (may be <code>null</code>) - * <LI><B>TABLE_SCHEM</B> String => table schema (may be <code>null</code>) - * <LI><B>TABLE_NAME</B> String => table name - * <LI><B>GRANTOR</B> String => grantor of access (may be <code>null</code>) - * <LI><B>GRANTEE</B> String => grantee of access - * <LI><B>PRIVILEGE</B> String => name of access (SELECT, + * <LI><B>TABLE_CAT</B> String {@code =>} table catalog (may be <code>null</code>) + * <LI><B>TABLE_SCHEM</B> String {@code =>} table schema (may be <code>null</code>) + * <LI><B>TABLE_NAME</B> String {@code =>} table name + * <LI><B>GRANTOR</B> String {@code =>} grantor of access (may be <code>null</code>) + * <LI><B>GRANTEE</B> String {@code =>} grantee of access + * <LI><B>PRIVILEGE</B> String {@code =>} name of access (SELECT, * INSERT, UPDATE, REFRENCES, ...) - * <LI><B>IS_GRANTABLE</B> String => "YES" if grantee is permitted + * <LI><B>IS_GRANTABLE</B> String {@code =>} "YES" if grantee is permitted * to grant to others; "NO" if not; <code>null</code> if unknown * </OL> * @@ -1783,21 +1783,21 @@ * * <P>Each column description has the following columns: * <OL> - * <LI><B>SCOPE</B> short => actual scope of result + * <LI><B>SCOPE</B> short {@code =>} actual scope of result * <UL> * <LI> bestRowTemporary - very temporary, while using row * <LI> bestRowTransaction - valid for remainder of current transaction * <LI> bestRowSession - valid for remainder of current session * </UL> - * <LI><B>COLUMN_NAME</B> String => column name - * <LI><B>DATA_TYPE</B> int => SQL data type from java.sql.Types - * <LI><B>TYPE_NAME</B> String => Data source dependent type name, + * <LI><B>COLUMN_NAME</B> String {@code =>} column name + * <LI><B>DATA_TYPE</B> int {@code =>} SQL data type from java.sql.Types + * <LI><B>TYPE_NAME</B> String {@code =>} Data source dependent type name, * for a UDT the type name is fully qualified - * <LI><B>COLUMN_SIZE</B> int => precision - * <LI><B>BUFFER_LENGTH</B> int => not used - * <LI><B>DECIMAL_DIGITS</B> short => scale - Null is returned for data types where + * <LI><B>COLUMN_SIZE</B> int {@code =>} precision + * <LI><B>BUFFER_LENGTH</B> int {@code =>} not used + * <LI><B>DECIMAL_DIGITS</B> short {@code =>} scale - Null is returned for data types where * DECIMAL_DIGITS is not applicable. - * <LI><B>PSEUDO_COLUMN</B> short => is this a pseudo column + * <LI><B>PSEUDO_COLUMN</B> short {@code =>} is this a pseudo column * like an Oracle ROWID * <UL> * <LI> bestRowUnknown - may or may not be pseudo column @@ -1902,15 +1902,15 @@ * * <P>Each column description has the following columns: * <OL> - * <LI><B>SCOPE</B> short => is not used - * <LI><B>COLUMN_NAME</B> String => column name - * <LI><B>DATA_TYPE</B> int => SQL data type from <code>java.sql.Types</code> - * <LI><B>TYPE_NAME</B> String => Data source-dependent type name - * <LI><B>COLUMN_SIZE</B> int => precision - * <LI><B>BUFFER_LENGTH</B> int => length of column value in bytes - * <LI><B>DECIMAL_DIGITS</B> short => scale - Null is returned for data types where + * <LI><B>SCOPE</B> short {@code =>} is not used + * <LI><B>COLUMN_NAME</B> String {@code =>} column name + * <LI><B>DATA_TYPE</B> int {@code =>} SQL data type from <code>java.sql.Types</code> + * <LI><B>TYPE_NAME</B> String {@code =>} Data source-dependent type name + * <LI><B>COLUMN_SIZE</B> int {@code =>} precision + * <LI><B>BUFFER_LENGTH</B> int {@code =>} length of column value in bytes + * <LI><B>DECIMAL_DIGITS</B> short {@code =>} scale - Null is returned for data types where * DECIMAL_DIGITS is not applicable. - * <LI><B>PSEUDO_COLUMN</B> short => whether this is pseudo column + * <LI><B>PSEUDO_COLUMN</B> short {@code =>} whether this is pseudo column * like an Oracle ROWID * <UL> * <LI> versionColumnUnknown - may or may not be pseudo column @@ -1978,14 +1978,14 @@ * * <P>Each primary key column description has the following columns: * <OL> - * <LI><B>TABLE_CAT</B> String => table catalog (may be <code>null</code>) - * <LI><B>TABLE_SCHEM</B> String => table schema (may be <code>null</code>) - * <LI><B>TABLE_NAME</B> String => table name - * <LI><B>COLUMN_NAME</B> String => column name - * <LI><B>KEY_SEQ</B> short => sequence number within primary key( a value + * <LI><B>TABLE_CAT</B> String {@code =>} table catalog (may be <code>null</code>) + * <LI><B>TABLE_SCHEM</B> String {@code =>} table schema (may be <code>null</code>) + * <LI><B>TABLE_NAME</B> String {@code =>} table name + * <LI><B>COLUMN_NAME</B> String {@code =>} column name + * <LI><B>KEY_SEQ</B> short {@code =>} sequence number within primary key( a value * of 1 represents the first column of the primary key, a value of 2 would * represent the second column within the primary key). - * <LI><B>PK_NAME</B> String => primary key name (may be <code>null</code>) + * <LI><B>PK_NAME</B> String {@code =>} primary key name (may be <code>null</code>) * </OL> * * @param catalog a catalog name; must match the catalog name as it @@ -2012,22 +2012,22 @@ * * <P>Each primary key column description has the following columns: * <OL> - * <LI><B>PKTABLE_CAT</B> String => primary key table catalog + * <LI><B>PKTABLE_CAT</B> String {@code =>} primary key table catalog * being imported (may be <code>null</code>) - * <LI><B>PKTABLE_SCHEM</B> String => primary key table schema + * <LI><B>PKTABLE_SCHEM</B> String {@code =>} primary key table schema * being imported (may be <code>null</code>) - * <LI><B>PKTABLE_NAME</B> String => primary key table name + * <LI><B>PKTABLE_NAME</B> String {@code =>} primary key table name * being imported - * <LI><B>PKCOLUMN_NAME</B> String => primary key column name + * <LI><B>PKCOLUMN_NAME</B> String {@code =>} primary key column name * being imported - * <LI><B>FKTABLE_CAT</B> String => foreign key table catalog (may be <code>null</code>) - * <LI><B>FKTABLE_SCHEM</B> String => foreign key table schema (may be <code>null</code>) - * <LI><B>FKTABLE_NAME</B> String => foreign key table name - * <LI><B>FKCOLUMN_NAME</B> String => foreign key column name - * <LI><B>KEY_SEQ</B> short => sequence number within a foreign key( a value + * <LI><B>FKTABLE_CAT</B> String {@code =>} foreign key table catalog (may be <code>null</code>) + * <LI><B>FKTABLE_SCHEM</B> String {@code =>} foreign key table schema (may be <code>null</code>) + * <LI><B>FKTABLE_NAME</B> String {@code =>} foreign key table name + * <LI><B>FKCOLUMN_NAME</B> String {@code =>} foreign key column name + * <LI><B>KEY_SEQ</B> short {@code =>} sequence number within a foreign key( a value * of 1 represents the first column of the foreign key, a value of 2 would * represent the second column within the foreign key). - * <LI><B>UPDATE_RULE</B> short => What happens to a + * <LI><B>UPDATE_RULE</B> short {@code =>} What happens to a * foreign key when the primary key is updated: * <UL> * <LI> importedNoAction - do not allow update of primary @@ -2041,7 +2041,7 @@ * <LI> importedKeyRestrict - same as importedKeyNoAction * (for ODBC 2.x compatibility) * </UL> - * <LI><B>DELETE_RULE</B> short => What happens to + * <LI><B>DELETE_RULE</B> short {@code =>} What happens to * the foreign key when primary is deleted. * <UL> * <LI> importedKeyNoAction - do not allow delete of primary @@ -2054,9 +2054,9 @@ * <LI> importedKeySetDefault - change imported key to default if * its primary key has been deleted * </UL> - * <LI><B>FK_NAME</B> String => foreign key name (may be <code>null</code>) - * <LI><B>PK_NAME</B> String => primary key name (may be <code>null</code>) - * <LI><B>DEFERRABILITY</B> short => can the evaluation of foreign key + * <LI><B>FK_NAME</B> String {@code =>} foreign key name (may be <code>null</code>) + * <LI><B>PK_NAME</B> String {@code =>} primary key name (may be <code>null</code>) + * <LI><B>DEFERRABILITY</B> short {@code =>} can the evaluation of foreign key * constraints be deferred until commit * <UL> * <LI> importedKeyInitiallyDeferred - see SQL92 for definition @@ -2195,22 +2195,22 @@ * * <P>Each foreign key column description has the following columns: * <OL> - * <LI><B>PKTABLE_CAT</B> String => primary key table catalog (may be <code>null</code>) - * <LI><B>PKTABLE_SCHEM</B> String => primary key table schema (may be <code>null</code>) - * <LI><B>PKTABLE_NAME</B> String => primary key table name - * <LI><B>PKCOLUMN_NAME</B> String => primary key column name - * <LI><B>FKTABLE_CAT</B> String => foreign key table catalog (may be <code>null</code>) + * <LI><B>PKTABLE_CAT</B> String {@code =>} primary key table catalog (may be <code>null</code>) + * <LI><B>PKTABLE_SCHEM</B> String {@code =>} primary key table schema (may be <code>null</code>) + * <LI><B>PKTABLE_NAME</B> String {@code =>} primary key table name + * <LI><B>PKCOLUMN_NAME</B> String {@code =>} primary key column name + * <LI><B>FKTABLE_CAT</B> String {@code =>} foreign key table catalog (may be <code>null</code>) * being exported (may be <code>null</code>) - * <LI><B>FKTABLE_SCHEM</B> String => foreign key table schema (may be <code>null</code>) + * <LI><B>FKTABLE_SCHEM</B> String {@code =>} foreign key table schema (may be <code>null</code>) * being exported (may be <code>null</code>) - * <LI><B>FKTABLE_NAME</B> String => foreign key table name + * <LI><B>FKTABLE_NAME</B> String {@code =>} foreign key table name * being exported - * <LI><B>FKCOLUMN_NAME</B> String => foreign key column name + * <LI><B>FKCOLUMN_NAME</B> String {@code =>} foreign key column name * being exported - * <LI><B>KEY_SEQ</B> short => sequence number within foreign key( a value + * <LI><B>KEY_SEQ</B> short {@code =>} sequence number within foreign key( a value * of 1 represents the first column of the foreign key, a value of 2 would * represent the second column within the foreign key). - * <LI><B>UPDATE_RULE</B> short => What happens to + * <LI><B>UPDATE_RULE</B> short {@code =>} What happens to * foreign key when primary is updated: * <UL> * <LI> importedNoAction - do not allow update of primary @@ -2224,7 +2224,7 @@ * <LI> importedKeyRestrict - same as importedKeyNoAction * (for ODBC 2.x compatibility) * </UL> - * <LI><B>DELETE_RULE</B> short => What happens to + * <LI><B>DELETE_RULE</B> short {@code =>} What happens to * the foreign key when primary is deleted. * <UL> * <LI> importedKeyNoAction - do not allow delete of primary @@ -2237,9 +2237,9 @@ * <LI> importedKeySetDefault - change imported key to default if * its primary key has been deleted * </UL> - * <LI><B>FK_NAME</B> String => foreign key name (may be <code>null</code>) - * <LI><B>PK_NAME</B> String => primary key name (may be <code>null</code>) - * <LI><B>DEFERRABILITY</B> short => can the evaluation of foreign key + * <LI><B>FK_NAME</B> String {@code =>} foreign key name (may be <code>null</code>) + * <LI><B>PK_NAME</B> String {@code =>} primary key name (may be <code>null</code>) + * <LI><B>DEFERRABILITY</B> short {@code =>} can the evaluation of foreign key * constraints be deferred until commit * <UL> * <LI> importedKeyInitiallyDeferred - see SQL92 for definition @@ -2276,22 +2276,22 @@ * * <P>Each foreign key column description has the following columns: * <OL> - * <LI><B>PKTABLE_CAT</B> String => parent key table catalog (may be <code>null</code>) - * <LI><B>PKTABLE_SCHEM</B> String => parent key table schema (may be <code>null</code>) - * <LI><B>PKTABLE_NAME</B> String => parent key table name - * <LI><B>PKCOLUMN_NAME</B> String => parent key column name - * <LI><B>FKTABLE_CAT</B> String => foreign key table catalog (may be <code>null</code>) + * <LI><B>PKTABLE_CAT</B> String {@code =>} parent key table catalog (may be <code>null</code>) + * <LI><B>PKTABLE_SCHEM</B> String {@code =>} parent key table schema (may be <code>null</code>) + * <LI><B>PKTABLE_NAME</B> String {@code =>} parent key table name + * <LI><B>PKCOLUMN_NAME</B> String {@code =>} parent key column name + * <LI><B>FKTABLE_CAT</B> String {@code =>} foreign key table catalog (may be <code>null</code>) * being exported (may be <code>null</code>) - * <LI><B>FKTABLE_SCHEM</B> String => foreign key table schema (may be <code>null</code>) + * <LI><B>FKTABLE_SCHEM</B> String {@code =>} foreign key table schema (may be <code>null</code>) * being exported (may be <code>null</code>) - * <LI><B>FKTABLE_NAME</B> String => foreign key table name + * <LI><B>FKTABLE_NAME</B> String {@code =>} foreign key table name * being exported - * <LI><B>FKCOLUMN_NAME</B> String => foreign key column name + * <LI><B>FKCOLUMN_NAME</B> String {@code =>} foreign key column name * being exported - * <LI><B>KEY_SEQ</B> short => sequence number within foreign key( a value + * <LI><B>KEY_SEQ</B> short {@code =>} sequence number within foreign key( a value * of 1 represents the first column of the foreign key, a value of 2 would * represent the second column within the foreign key). - * <LI><B>UPDATE_RULE</B> short => What happens to + * <LI><B>UPDATE_RULE</B> short {@code =>} What happens to * foreign key when parent key is updated: * <UL> * <LI> importedNoAction - do not allow update of parent @@ -2305,7 +2305,7 @@ * <LI> importedKeyRestrict - same as importedKeyNoAction * (for ODBC 2.x compatibility) * </UL> - * <LI><B>DELETE_RULE</B> short => What happens to + * <LI><B>DELETE_RULE</B> short {@code =>} What happens to * the foreign key when parent key is deleted. * <UL> * <LI> importedKeyNoAction - do not allow delete of parent @@ -2318,9 +2318,9 @@ * <LI> importedKeySetDefault - change imported key to default if * its parent key has been deleted * </UL> - * <LI><B>FK_NAME</B> String => foreign key name (may be <code>null</code>) - * <LI><B>PK_NAME</B> String => parent key name (may be <code>null</code>) - * <LI><B>DEFERRABILITY</B> short => can the evaluation of foreign key + * <LI><B>FK_NAME</B> String {@code =>} foreign key name (may be <code>null</code>) + * <LI><B>PK_NAME</B> String {@code =>} parent key name (may be <code>null</code>) + * <LI><B>DEFERRABILITY</B> short {@code =>} can the evaluation of foreign key * constraints be deferred until commit * <UL> * <LI> importedKeyInitiallyDeferred - see SQL92 for definition @@ -2371,40 +2371,40 @@ * * <P>Each type description has the following columns: * <OL> - * <LI><B>TYPE_NAME</B> String => Type name - * <LI><B>DATA_TYPE</B> int => SQL data type from java.sql.Types - * <LI><B>PRECISION</B> int => maximum precision - * <LI><B>LITERAL_PREFIX</B> String => prefix used to quote a literal + * <LI><B>TYPE_NAME</B> String {@code =>} Type name + * <LI><B>DATA_TYPE</B> int {@code =>} SQL data type from java.sql.Types + * <LI><B>PRECISION</B> int {@code =>} maximum precision + * <LI><B>LITERAL_PREFIX</B> String {@code =>} prefix used to quote a literal * (may be <code>null</code>) - * <LI><B>LITERAL_SUFFIX</B> String => suffix used to quote a literal + * <LI><B>LITERAL_SUFFIX</B> String {@code =>} suffix used to quote a literal (may be <code>null</code>) - * <LI><B>CREATE_PARAMS</B> String => parameters used in creating + * <LI><B>CREATE_PARAMS</B> String {@code =>} parameters used in creating * the type (may be <code>null</code>) - * <LI><B>NULLABLE</B> short => can you use NULL for this type. + * <LI><B>NULLABLE</B> short {@code =>} can you use NULL for this type. * <UL> * <LI> typeNoNulls - does not allow NULL values * <LI> typeNullable - allows NULL values * <LI> typeNullableUnknown - nullability unknown * </UL> - * <LI><B>CASE_SENSITIVE</B> boolean=> is it case sensitive. - * <LI><B>SEARCHABLE</B> short => can you use "WHERE" based on this type: + * <LI><B>CASE_SENSITIVE</B> boolean{@code =>} is it case sensitive. + * <LI><B>SEARCHABLE</B> short {@code =>} can you use "WHERE" based on this type: * <UL> * <LI> typePredNone - No support * <LI> typePredChar - Only supported with WHERE .. LIKE * <LI> typePredBasic - Supported except for WHERE .. LIKE * <LI> typeSearchable - Supported for all WHERE .. * </UL> - * <LI><B>UNSIGNED_ATTRIBUTE</B> boolean => is it unsigned. - * <LI><B>FIXED_PREC_SCALE</B> boolean => can it be a money value. - * <LI><B>AUTO_INCREMENT</B> boolean => can it be used for an + * <LI><B>UNSIGNED_ATTRIBUTE</B> boolean {@code =>} is it unsigned. + * <LI><B>FIXED_PREC_SCALE</B> boolean {@code =>} can it be a money value. + * <LI><B>AUTO_INCREMENT</B> boolean {@code =>} can it be used for an * auto-increment value. - * <LI><B>LOCAL_TYPE_NAME</B> String => localized version of type name + * <LI><B>LOCAL_TYPE_NAME</B> String {@code =>} localized version of type name * (may be <code>null</code>) - * <LI><B>MINIMUM_SCALE</B> short => minimum scale supported - * <LI><B>MAXIMUM_SCALE</B> short => maximum scale supported - * <LI><B>SQL_DATA_TYPE</B> int => unused - * <LI><B>SQL_DATETIME_SUB</B> int => unused - * <LI><B>NUM_PREC_RADIX</B> int => usually 2 or 10 + * <LI><B>MINIMUM_SCALE</B> short {@code =>} minimum scale supported + * <LI><B>MAXIMUM_SCALE</B> short {@code =>} maximum scale supported + * <LI><B>SQL_DATA_TYPE</B> int {@code =>} unused + * <LI><B>SQL_DATETIME_SUB</B> int {@code =>} unused + * <LI><B>NUM_PREC_RADIX</B> int {@code =>} usually 2 or 10 * </OL> * * <p>The PRECISION column represents the maximum column size that the server supports for the given datatype. @@ -2498,16 +2498,16 @@ * * <P>Each index column description has the following columns: * <OL> - * <LI><B>TABLE_CAT</B> String => table catalog (may be <code>null</code>) - * <LI><B>TABLE_SCHEM</B> String => table schema (may be <code>null</code>) - * <LI><B>TABLE_NAME</B> String => table name - * <LI><B>NON_UNIQUE</B> boolean => Can index values be non-unique. + * <LI><B>TABLE_CAT</B> String {@code =>} table catalog (may be <code>null</code>) + * <LI><B>TABLE_SCHEM</B> String {@code =>} table schema (may be <code>null</code>) + * <LI><B>TABLE_NAME</B> String {@code =>} table name + * <LI><B>NON_UNIQUE</B> boolean {@code =>} Can index values be non-unique. * false when TYPE is tableIndexStatistic - * <LI><B>INDEX_QUALIFIER</B> String => index catalog (may be <code>null</code>); + * <LI><B>INDEX_QUALIFIER</B> String {@code =>} index catalog (may be <code>null</code>); * <code>null</code> when TYPE is tableIndexStatistic - * <LI><B>INDEX_NAME</B> String => index name; <code>null</code> when TYPE is + * <LI><B>INDEX_NAME</B> String {@code =>} index name; <code>null</code> when TYPE is * tableIndexStatistic - * <LI><B>TYPE</B> short => index type: + * <LI><B>TYPE</B> short {@code =>} index type: * <UL> * <LI> tableIndexStatistic - this identifies table statistics that are * returned in conjuction with a table's index descriptions @@ -2515,20 +2515,20 @@ * <LI> tableIndexHashed - this is a hashed index * <LI> tableIndexOther - this is some other style of index * </UL> - * <LI><B>ORDINAL_POSITION</B> short => column sequence number + * <LI><B>ORDINAL_POSITION</B> short {@code =>} column sequence number * within index; zero when TYPE is tableIndexStatistic * <LI><B>COLUMN_NAME</B> String => column name; <code>null</code> when TYPE is * tableIndexStatistic - * <LI><B>ASC_OR_DESC</B> String => column sort sequence, "A" => ascending, - * "D" => descending, may be <code>null</code> if sort sequence is not supported; + * <LI><B>ASC_OR_DESC</B> String {@code =>} column sort sequence, "A" {@code =>} ascending, + * "D" {@code =>} descending, may be <code>null</code> if sort sequence is not supported; * <code>null</code> when TYPE is tableIndexStatistic - * <LI><B>CARDINALITY</B> int => When TYPE is tableIndexStatistic, then + * <LI><B>CARDINALITY</B> int {@code =>} When TYPE is tableIndexStatistic, then * this is the number of rows in the table; otherwise, it is the * number of unique values in the index. - * <LI><B>PAGES</B> int => When TYPE is tableIndexStatisic then + * <LI><B>PAGES</B> int {@code =>} When TYPE is tableIndexStatisic then * this is the number of pages used for the table, otherwise it * is the number of pages used for the current index. - * <LI><B>FILTER_CONDITION</B> String => Filter condition, if any. + * <LI><B>FILTER_CONDITION</B> String {@code =>} Filter condition, if any. * (may be <code>null</code>) * </OL> * @@ -2781,14 +2781,14 @@ * * <P>Each type description has the following columns: * <OL> - * <LI><B>TYPE_CAT</B> String => the type's catalog (may be <code>null</code>) - * <LI><B>TYPE_SCHEM</B> String => type's schema (may be <code>null</code>) - * <LI><B>TYPE_NAME</B> String => type name - * <LI><B>CLASS_NAME</B> String => Java class name - * <LI><B>DATA_TYPE</B> int => type value defined in java.sql.Types. + * <LI><B>TYPE_CAT</B> String {@code =>} the type's catalog (may be <code>null</code>) + * <LI><B>TYPE_SCHEM</B> String {@code =>} type's schema (may be <code>null</code>) + * <LI><B>TYPE_NAME</B> String {@code =>} type name + * <LI><B>CLASS_NAME</B> String {@code =>} Java class name + * <LI><B>DATA_TYPE</B> int {@code =>} type value defined in java.sql.Types. * One of JAVA_OBJECT, STRUCT, or DISTINCT - * <LI><B>REMARKS</B> String => explanatory comment on the type - * <LI><B>BASE_TYPE</B> short => type code of the source type of a + * <LI><B>REMARKS</B> String {@code =>} explanatory comment on the type + * <LI><B>BASE_TYPE</B> short {@code =>} type code of the source type of a * DISTINCT type or the type that implements the user-generated * reference type of the SELF_REFERENCING_COLUMN of a structured * type as defined in java.sql.Types (<code>null</code> if DATA_TYPE is not @@ -2894,14 +2894,14 @@ * describes the designated UDT and a direct supertype. A row has the following * columns: * <OL> - * <LI><B>TYPE_CAT</B> String => the UDT's catalog (may be <code>null</code>) - * <LI><B>TYPE_SCHEM</B> String => UDT's schema (may be <code>null</code>) - * <LI><B>TYPE_NAME</B> String => type name of the UDT - * <LI><B>SUPERTYPE_CAT</B> String => the direct super type's catalog + * <LI><B>TYPE_CAT</B> String {@code =>} the UDT's catalog (may be <code>null</code>) + * <LI><B>TYPE_SCHEM</B> String {@code =>} UDT's schema (may be <code>null</code>) + * <LI><B>TYPE_NAME</B> String {@code =>} type name of the UDT + * <LI><B>SUPERTYPE_CAT</B> String {@code =>} the direct super type's catalog * (may be <code>null</code>) - * <LI><B>SUPERTYPE_SCHEM</B> String => the direct super type's schema + * <LI><B>SUPERTYPE_SCHEM</B> String {@code =>} the direct super type's schema * (may be <code>null</code>) - * <LI><B>SUPERTYPE_NAME</B> String => the direct super type's name + * <LI><B>SUPERTYPE_NAME</B> String {@code =>} the direct super type's name * </OL> * * <P><B>Note:</B> If the driver does not support type hierarchies, an @@ -2936,10 +2936,10 @@ * * <P>Each type description has the following columns: * <OL> - * <LI><B>TABLE_CAT</B> String => the type's catalog (may be <code>null</code>) - * <LI><B>TABLE_SCHEM</B> String => type's schema (may be <code>null</code>) - * <LI><B>TABLE_NAME</B> String => type name - * <LI><B>SUPERTABLE_NAME</B> String => the direct super type's name + * <LI><B>TABLE_CAT</B> String {@code =>} the type's catalog (may be <code>null</code>) + * <LI><B>TABLE_SCHEM</B> String {@code =>} type's schema (may be <code>null</code>) + * <LI><B>TABLE_NAME</B> String {@code =>} type name + * <LI><B>SUPERTABLE_NAME</B> String {@code =>} the direct super type's name * </OL> * * <P><B>Note:</B> If the driver does not support type hierarchies, an @@ -3001,35 +3001,35 @@ * The <code>ResultSet</code> object that is returned has the following * columns: * <OL> - * <LI><B>TYPE_CAT</B> String => type catalog (may be <code>null</code>) - * <LI><B>TYPE_SCHEM</B> String => type schema (may be <code>null</code>) - * <LI><B>TYPE_NAME</B> String => type name - * <LI><B>ATTR_NAME</B> String => attribute name - * <LI><B>DATA_TYPE</B> int => attribute type SQL type from java.sql.Types - * <LI><B>ATTR_TYPE_NAME</B> String => Data source dependent type name. + * <LI><B>TYPE_CAT</B> String {@code =>} type catalog (may be <code>null</code>) + * <LI><B>TYPE_SCHEM</B> String {@code =>} type schema (may be <code>null</code>) + * <LI><B>TYPE_NAME</B> String {@code =>} type name + * <LI><B>ATTR_NAME</B> String {@code =>} attribute name + * <LI><B>DATA_TYPE</B> int {@code =>} attribute type SQL type from java.sql.Types + * <LI><B>ATTR_TYPE_NAME</B> String {@code =>} Data source dependent type name. * For a UDT, the type name is fully qualified. For a REF, the type name is * fully qualified and represents the target type of the reference type. - * <LI><B>ATTR_SIZE</B> int => column size. For char or date + * <LI><B>ATTR_SIZE</B> int {@code =>} column size. For char or date * types this is the maximum number of characters; for numeric or * decimal types this is precision. - * <LI><B>DECIMAL_DIGITS</B> int => the number of fractional digits. Null is returned for data types where + * <LI><B>DECIMAL_DIGITS</B> int {@code =>} the number of fractional digits. Null is returned for data types where * DECIMAL_DIGITS is not applicable. - * <LI><B>NUM_PREC_RADIX</B> int => Radix (typically either 10 or 2) - * <LI><B>NULLABLE</B> int => whether NULL is allowed + * <LI><B>NUM_PREC_RADIX</B> int {@code =>} Radix (typically either 10 or 2) + * <LI><B>NULLABLE</B> int {@code =>} whether NULL is allowed * <UL> * <LI> attributeNoNulls - might not allow NULL values * <LI> attributeNullable - definitely allows NULL values * <LI> attributeNullableUnknown - nullability unknown * </UL> - * <LI><B>REMARKS</B> String => comment describing column (may be <code>null</code>) - * <LI><B>ATTR_DEF</B> String => default value (may be <code>null</code>) - * <LI><B>SQL_DATA_TYPE</B> int => unused - * <LI><B>SQL_DATETIME_SUB</B> int => unused - * <LI><B>CHAR_OCTET_LENGTH</B> int => for char types the + * <LI><B>REMARKS</B> String {@code =>} comment describing column (may be <code>null</code>) + * <LI><B>ATTR_DEF</B> String {@code =>} default value (may be <code>null</code>) + * <LI><B>SQL_DATA_TYPE</B> int {@code =>} unused + * <LI><B>SQL_DATETIME_SUB</B> int {@code =>} unused + * <LI><B>CHAR_OCTET_LENGTH</B> int {@code =>} for char types the * maximum number of bytes in the column - * <LI><B>ORDINAL_POSITION</B> int => index of the attribute in the UDT + * <LI><B>ORDINAL_POSITION</B> int {@code =>} index of the attribute in the UDT * (starting at 1) - * <LI><B>IS_NULLABLE</B> String => ISO rules are used to determine + * <LI><B>IS_NULLABLE</B> String {@code =>} ISO rules are used to determine * the nullability for a attribute. * <UL> * <LI> YES --- if the attribute can include NULLs @@ -3037,13 +3037,13 @@ * <LI> empty string --- if the nullability for the * attribute is unknown * </UL> - * <LI><B>SCOPE_CATALOG</B> String => catalog of table that is the + * <LI><B>SCOPE_CATALOG</B> String {@code =>} catalog of table that is the * scope of a reference attribute (<code>null</code> if DATA_TYPE isn't REF) - * <LI><B>SCOPE_SCHEMA</B> String => schema of table that is the + * <LI><B>SCOPE_SCHEMA</B> String {@code =>} schema of table that is the * scope of a reference attribute (<code>null</code> if DATA_TYPE isn't REF) - * <LI><B>SCOPE_TABLE</B> String => table name that is the scope of a + * <LI><B>SCOPE_TABLE</B> String {@code =>} table name that is the scope of a * reference attribute (<code>null</code> if the DATA_TYPE isn't REF) - * <LI><B>SOURCE_DATA_TYPE</B> short => source type of a distinct type or user-generated + * <LI><B>SOURCE_DATA_TYPE</B> short {@code =>} source type of a distinct type or user-generated * Ref type,SQL type from java.sql.Types (<code>null</code> if DATA_TYPE * isn't DISTINCT or user-generated REF) * </OL> @@ -3203,14 +3203,14 @@ * and if so the lifetime for which a <code>RowId</code> object remains valid. * <p> * The returned int values have the following relationship: - * <pre> + * <pre>{@code * ROWID_UNSUPPORTED < ROWID_VALID_OTHER < ROWID_VALID_TRANSACTION * < ROWID_VALID_SESSION < ROWID_VALID_FOREVER - * </pre> + * }</pre> * so conditional logic such as - * <pre> + * <pre>{@code * if (metadata.getRowIdLifetime() > DatabaseMetaData.ROWID_VALID_TRANSACTION) - * </pre> + * }</pre> * can be used. Valid Forever means valid across all Sessions, and valid for * a Session means valid across all its contained Transactions. * @@ -3227,8 +3227,8 @@ * * <P>The schema columns are: * <OL> - * <LI><B>TABLE_SCHEM</B> String => schema name - * <LI><B>TABLE_CATALOG</B> String => catalog name (may be <code>null</code>) + * <LI><B>TABLE_SCHEM</B> String {@code =>} schema name + * <LI><B>TABLE_CATALOG</B> String {@code =>} catalog name (may be <code>null</code>) * </OL> * * @@ -3273,10 +3273,10 @@ * that the driver supports. The result set contains the following columns * <p> * <ol> - * <li><b>NAME</b> String=> The name of the client info property<br> - * <li><b>MAX_LEN</b> int=> The maximum length of the value for the property<br> - * <li><b>DEFAULT_VALUE</b> String=> The default value of the property<br> - * <li><b>DESCRIPTION</b> String=> A description of the property. This will typically + * <li><b>NAME</b> String{@code =>} The name of the client info property<br> + * <li><b>MAX_LEN</b> int{@code =>} The maximum length of the value for the property<br> + * <li><b>DEFAULT_VALUE</b> String{@code =>} The default value of the property<br> + * <li><b>DESCRIPTION</b> String{@code =>} A description of the property. This will typically * contain information as to where this property is * stored in the database. * </ol> @@ -3305,19 +3305,19 @@ * * <P>Each function description has the the following columns: * <OL> - * <LI><B>FUNCTION_CAT</B> String => function catalog (may be <code>null</code>) - * <LI><B>FUNCTION_SCHEM</B> String => function schema (may be <code>null</code>) - * <LI><B>FUNCTION_NAME</B> String => function name. This is the name + * <LI><B>FUNCTION_CAT</B> String {@code =>} function catalog (may be <code>null</code>) + * <LI><B>FUNCTION_SCHEM</B> String {@code =>} function schema (may be <code>null</code>) + * <LI><B>FUNCTION_NAME</B> String {@code =>} function name. This is the name * used to invoke the function - * <LI><B>REMARKS</B> String => explanatory comment on the function - * <LI><B>FUNCTION_TYPE</B> short => kind of function: + * <LI><B>REMARKS</B> String {@code =>} explanatory comment on the function + * <LI><B>FUNCTION_TYPE</B> short {@code =>} kind of function: * <UL> * <LI>functionResultUnknown - Cannot determine if a return value * or table will be returned * <LI> functionNoTable- Does not return a table * <LI> functionReturnsTable - Returns a table * </UL> - * <LI><B>SPECIFIC_NAME</B> String => the name which uniquely identifies + * <LI><B>SPECIFIC_NAME</B> String {@code =>} the name which uniquely identifies * this function within its schema. This is a user specified, or DBMS * generated, name that may be different then the <code>FUNCTION_NAME</code> * for example with overload functions @@ -3359,12 +3359,12 @@ * is a parameter description, column description or * return type description with the following fields: * <OL> - * <LI><B>FUNCTION_CAT</B> String => function catalog (may be <code>null</code>) - * <LI><B>FUNCTION_SCHEM</B> String => function schema (may be <code>null</code>) - * <LI><B>FUNCTION_NAME</B> String => function name. This is the name + * <LI><B>FUNCTION_CAT</B> String {@code =>} function catalog (may be <code>null</code>) + * <LI><B>FUNCTION_SCHEM</B> String {@code =>} function schema (may be <code>null</code>) + * <LI><B>FUNCTION_NAME</B> String {@code =>} function name. This is the name * used to invoke the function - * <LI><B>COLUMN_NAME</B> String => column/parameter name - * <LI><B>COLUMN_TYPE</B> Short => kind of column/parameter: + * <LI><B>COLUMN_NAME</B> String {@code =>} column/parameter name + * <LI><B>COLUMN_TYPE</B> Short {@code =>} kind of column/parameter: * <UL> * <LI> functionColumnUnknown - nobody knows * <LI> functionColumnIn - IN parameter @@ -3374,30 +3374,30 @@ * <LI> functionColumnResult - Indicates that the parameter or column * is a column in the <code>ResultSet</code> * </UL> - * <LI><B>DATA_TYPE</B> int => SQL type from java.sql.Types - * <LI><B>TYPE_NAME</B> String => SQL type name, for a UDT type the + * <LI><B>DATA_TYPE</B> int {@code =>} SQL type from java.sql.Types + * <LI><B>TYPE_NAME</B> String {@code =>} SQL type name, for a UDT type the * type name is fully qualified - * <LI><B>PRECISION</B> int => precision - * <LI><B>LENGTH</B> int => length in bytes of data - * <LI><B>SCALE</B> short => scale - null is returned for data types where + * <LI><B>PRECISION</B> int {@code =>} precision + * <LI><B>LENGTH</B> int {@code =>} length in bytes of data + * <LI><B>SCALE</B> short {@code =>} scale - null is returned for data types where * SCALE is not applicable. - * <LI><B>RADIX</B> short => radix - * <LI><B>NULLABLE</B> short => can it contain NULL. + * <LI><B>RADIX</B> short {@code =>} radix + * <LI><B>NULLABLE</B> short {@code =>} can it contain NULL. * <UL> * <LI> functionNoNulls - does not allow NULL values * <LI> functionNullable - allows NULL values * <LI> functionNullableUnknown - nullability unknown * </UL> - * <LI><B>REMARKS</B> String => comment describing column/parameter - * <LI><B>CHAR_OCTET_LENGTH</B> int => the maximum length of binary + * <LI><B>REMARKS</B> String {@code =>} comment describing column/parameter + * <LI><B>CHAR_OCTET_LENGTH</B> int {@code =>} the maximum length of binary * and character based parameters or columns. For any other datatype the returned value * is a NULL - * <LI><B>ORDINAL_POSITION</B> int => the ordinal position, starting + * <LI><B>ORDINAL_POSITION</B> int {@code =>} the ordinal position, starting * from 1, for the input and output parameters. A value of 0 * is returned if this row describes the function's return value. * For result set columns, it is the * ordinal position of the column in the result set starting from 1. - * <LI><B>IS_NULLABLE</B> String => ISO rules are used to determine + * <LI><B>IS_NULLABLE</B> String {@code =>} ISO rules are used to determine * the nullability for a parameter or column. * <UL> * <LI> YES --- if the parameter or column can include NULLs @@ -3405,7 +3405,7 @@ * <LI> empty string --- if the nullability for the * parameter or column is unknown * </UL> - * <LI><B>SPECIFIC_NAME</B> String => the name which uniquely identifies + * <LI><B>SPECIFIC_NAME</B> String {@code =>} the name which uniquely identifies * this function within its schema. This is a user specified, or DBMS * generated, name that may be different then the <code>FUNCTION_NAME</code> * for example with overload functions @@ -3591,21 +3591,21 @@ * * <P>Each column description has the following columns: * <OL> - * <LI><B>TABLE_CAT</B> String => table catalog (may be <code>null</code>) - * <LI><B>TABLE_SCHEM</B> String => table schema (may be <code>null</code>) - * <LI><B>TABLE_NAME</B> String => table name - * <LI><B>COLUMN_NAME</B> String => column name - * <LI><B>DATA_TYPE</B> int => SQL type from java.sql.Types - * <LI><B>COLUMN_SIZE</B> int => column size. - * <LI><B>DECIMAL_DIGITS</B> int => the number of fractional digits. Null is returned for data types where + * <LI><B>TABLE_CAT</B> String {@code =>} table catalog (may be <code>null</code>) + * <LI><B>TABLE_SCHEM</B> String {@code =>} table schema (may be <code>null</code>) + * <LI><B>TABLE_NAME</B> String {@code =>} table name + * <LI><B>COLUMN_NAME</B> String {@code =>} column name + * <LI><B>DATA_TYPE</B> int {@code =>} SQL type from java.sql.Types + * <LI><B>COLUMN_SIZE</B> int {@code =>} column size. + * <LI><B>DECIMAL_DIGITS</B> int {@code =>} the number of fractional digits. Null is returned for data types where * DECIMAL_DIGITS is not applicable. - * <LI><B>NUM_PREC_RADIX</B> int => Radix (typically either 10 or 2) - * <LI><B>COLUMN_USAGE</B> String => The allowed usage for the column. The + * <LI><B>NUM_PREC_RADIX</B> int {@code =>} Radix (typically either 10 or 2) + * <LI><B>COLUMN_USAGE</B> String {@code =>} The allowed usage for the column. The * value returned will correspond to the enum name returned by {@link PseudoColumnUsage#name PseudoColumnUsage.name()} - * <LI><B>REMARKS</B> String => comment describing column (may be <code>null</code>) - * <LI><B>CHAR_OCTET_LENGTH</B> int => for char types the + * <LI><B>REMARKS</B> String {@code =>} comment describing column (may be <code>null</code>) + * <LI><B>CHAR_OCTET_LENGTH</B> int {@code =>} for char types the * maximum number of bytes in the column - * <LI><B>IS_NULLABLE</B> String => ISO rules are used to determine the nullability for a column. + * <LI><B>IS_NULLABLE</B> String {@code =>} ISO rules are used to determine the nullability for a column. * <UL> * <LI> YES --- if the column can include NULLs * <LI> NO --- if the column cannot include NULLs
--- a/src/share/classes/java/sql/DriverManager.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/sql/DriverManager.java Tue Jan 24 00:25:46 2017 +0000 @@ -35,7 +35,7 @@ /** * <P>The basic service for managing a set of JDBC drivers.<br> - * <B>NOTE:</B> The {@link <code>DataSource</code>} interface, new in the + * <B>NOTE:</B> The {@link javax.sql.DataSource} interface, new in the * JDBC 2.0 API, provides another way to connect to a data source. * The use of a <code>DataSource</code> object is the preferred means of * connecting to a data source.
--- a/src/share/classes/java/sql/ResultSet.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/sql/ResultSet.java Tue Jan 24 00:25:46 2017 +0000 @@ -1344,7 +1344,7 @@ * @param rows the number of rows to fetch * @exception SQLException if a database access error occurs; this method * is called on a closed result set or the - * condition <code>rows >= 0 </code> is not satisfied + * condition {@code rows >= 0} is not satisfied * @since 1.2 * @see #getFetchSize */
--- a/src/share/classes/java/sql/Statement.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/sql/Statement.java Tue Jan 24 00:25:46 2017 +0000 @@ -144,7 +144,7 @@ * @param max the new column size limit in bytes; zero means there is no limit * @exception SQLException if a database access error occurs, * this method is called on a closed <code>Statement</code> - * or the condition max >= 0 is not satisfied + * or the condition {@code max >= 0} is not satisfied * @see #getMaxFieldSize */ void setMaxFieldSize(int max) throws SQLException; @@ -174,7 +174,7 @@ * @param max the new max rows limit; zero means there is no limit * @exception SQLException if a database access error occurs, * this method is called on a closed <code>Statement</code> - * or the condition max >= 0 is not satisfied + * or the condition {@code max >= 0} is not satisfied * @see #getMaxRows */ void setMaxRows(int max) throws SQLException; @@ -232,7 +232,7 @@ * there is no limit * @exception SQLException if a database access error occurs, * this method is called on a closed <code>Statement</code> - * or the condition seconds >= 0 is not satisfied + * or the condition {@code seconds >= 0} is not satisfied * @see #getQueryTimeout */ void setQueryTimeout(int seconds) throws SQLException; @@ -377,10 +377,10 @@ * object(s) obtained with the method <code>getResultSet</code>. * * <P>There are no more results when the following is true: - * <PRE> + * <PRE>{@code * // stmt is a Statement object * ((stmt.getMoreResults() == false) && (stmt.getUpdateCount() == -1)) - * </PRE> + * }</PRE> * * @return <code>true</code> if the next result is a <code>ResultSet</code> * object; <code>false</code> if it is an update count or there are @@ -444,7 +444,7 @@ * @param rows the number of rows to fetch * @exception SQLException if a database access error occurs, * this method is called on a closed <code>Statement</code> or the - * condition <code>rows >= 0</code> is not satisfied. + * condition {@code rows >= 0} is not satisfied. * @since 1.2 * @see #getFetchSize */ @@ -657,10 +657,10 @@ * <code>true</code> if the next result is a <code>ResultSet</code> object. * * <P>There are no more results when the following is true: - * <PRE> + * <PRE>{@code * // stmt is a Statement object * ((stmt.getMoreResults(current) == false) && (stmt.getUpdateCount() == -1)) - * </PRE> + * }</PRE> * * @param current one of the following <code>Statement</code> * constants indicating what should happen to current
--- a/src/share/classes/java/text/CharacterIterator.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/text/CharacterIterator.java Tue Jan 24 00:25:46 2017 +0000 @@ -62,27 +62,27 @@ * <P>Examples:<P> * * Traverse the text from start to finish - * <pre> + * <pre>{@code * public void traverseForward(CharacterIterator iter) { * for(char c = iter.first(); c != CharacterIterator.DONE; c = iter.next()) { * processChar(c); * } * } - * </pre> + * }</pre> * * Traverse the text backwards, from end to start - * <pre> + * <pre>{@code * public void traverseBackward(CharacterIterator iter) { * for(char c = iter.last(); c != CharacterIterator.DONE; c = iter.previous()) { * processChar(c); * } * } - * </pre> + * }</pre> * * Traverse both forward and backward from a given position in the text. * Calls to notBoundary() in this example represents some * additional stopping criteria. - * <pre> + * <pre>{@code * public void traverseOut(CharacterIterator iter, int pos) { * for (char c = iter.setIndex(pos); * c != CharacterIterator.DONE && notBoundary(c); @@ -96,7 +96,7 @@ * int start = iter.getIndex(); * processSection(start, end); * } - * </pre> + * }</pre> * * @see StringCharacterIterator * @see AttributedCharacterIterator
--- a/src/share/classes/java/text/ChoiceFormat.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/text/ChoiceFormat.java Tue Jan 24 00:25:46 2017 +0000 @@ -374,7 +374,7 @@ /** * Returns pattern with formatted double. - * @param number number to be formatted & substituted. + * @param number number to be formatted and substituted. * @param toAppendTo where text is appended. * @param status ignore no useful status is returned. */
--- a/src/share/classes/java/text/Collator.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/text/Collator.java Tue Jan 24 00:25:46 2017 +0000 @@ -72,14 +72,14 @@ * The following example shows how to compare two strings using * the <code>Collator</code> for the default locale. * <blockquote> - * <pre> + * <pre>{@code * // Compare two strings in the default locale * Collator myCollator = Collator.getInstance(); * if( myCollator.compare("abc", "ABC") < 0 ) * System.out.println("abc is less than ABC"); * else * System.out.println("abc is greater than or equal to ABC"); - * </pre> + * }</pre> * </blockquote> * * <p>
--- a/src/share/classes/java/util/Calendar.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/util/Calendar.java Tue Jan 24 00:25:46 2017 +0000 @@ -1938,9 +1938,9 @@ * Returns whether this <code>Calendar</code> represents a time * before the time represented by the specified * <code>Object</code>. This method is equivalent to: - * <pre><blockquote> + * <pre>{@code * compareTo(when) < 0 - * </blockquote></pre> + * }</pre> * if and only if <code>when</code> is a <code>Calendar</code> * instance. Otherwise, the method returns <code>false</code>. * @@ -1959,9 +1959,9 @@ * Returns whether this <code>Calendar</code> represents a time * after the time represented by the specified * <code>Object</code>. This method is equivalent to: - * <pre><blockquote> + * <pre>{@code * compareTo(when) > 0 - * </blockquote></pre> + * }</pre> * if and only if <code>when</code> is a <code>Calendar</code> * instance. Otherwise, the method returns <code>false</code>. *
--- a/src/share/classes/java/util/Collections.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/util/Collections.java Tue Jan 24 00:25:46 2017 +0000 @@ -904,9 +904,9 @@ * Returns the starting position of the first occurrence of the specified * target list within the specified source list, or -1 if there is no * such occurrence. More formally, returns the lowest index <tt>i</tt> - * such that <tt>source.subList(i, i+target.size()).equals(target)</tt>, + * such that {@code source.subList(i, i+target.size()).equals(target)}, * or -1 if there is no such index. (Returns -1 if - * <tt>target.size() > source.size()</tt>.) + * {@code target.size() > source.size()}) * * <p>This implementation uses the "brute force" technique of scanning * over the source list, looking for a match with the target at each @@ -957,9 +957,9 @@ * Returns the starting position of the last occurrence of the specified * target list within the specified source list, or -1 if there is no such * occurrence. More formally, returns the highest index <tt>i</tt> - * such that <tt>source.subList(i, i+target.size()).equals(target)</tt>, + * such that {@code source.subList(i, i+target.size()).equals(target)}, * or -1 if there is no such index. (Returns -1 if - * <tt>target.size() > source.size()</tt>.) + * {@code target.size() > source.size()}) * * <p>This implementation uses the "brute force" technique of iterating * over the source list, looking for a match with the target at each
--- a/src/share/classes/java/util/Date.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/util/Date.java Tue Jan 24 00:25:46 2017 +0000 @@ -982,8 +982,9 @@ * exclusive OR of the two halves of the primitive <tt>long</tt> * value returned by the {@link Date#getTime} * method. That is, the hash code is the value of the expression: - * <blockquote><pre> - * (int)(this.getTime()^(this.getTime() >>> 32))</pre></blockquote> + * <blockquote><pre>{@code + * (int)(this.getTime()^(this.getTime() >>> 32)) + * }</pre></blockquote> * * @return a hash code value for this object. */ @@ -1083,7 +1084,7 @@ /** * Creates a string representation of this <tt>Date</tt> object of * the form: - * <blockquote<pre> + * <blockquote><pre> * d mon yyyy hh:mm:ss GMT</pre></blockquote> * where:<ul> * <li><i>d</i> is the day of the month (<tt>1</tt> through <tt>31</tt>),
--- a/src/share/classes/java/util/LinkedHashMap.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/util/LinkedHashMap.java Tue Jan 24 00:25:46 2017 +0000 @@ -456,13 +456,13 @@ * <p>Sample use: this override will allow the map to grow up to 100 * entries and then delete the eldest entry each time a new entry is * added, maintaining a steady state of 100 entries. - * <pre> + * <pre>{@code * private static final int MAX_ENTRIES = 100; * * protected boolean removeEldestEntry(Map.Entry eldest) { * return size() > MAX_ENTRIES; * } - * </pre> + * }</pre> * * <p>This method typically does not modify the map in any way, * instead allowing the map to modify itself as directed by its
--- a/src/share/classes/java/util/Random.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/util/Random.java Tue Jan 24 00:25:46 2017 +0000 @@ -368,7 +368,7 @@ * range {@code 0.0f} (inclusive) to {@code 1.0f} (exclusive), is * pseudorandomly generated and returned. All 2<font * size="-1"><sup>24</sup></font> possible {@code float} values - * of the form <i>m x </i>2<font + * of the form <i>m x </i>2<font * size="-1"><sup>-24</sup></font>, where <i>m</i> is a positive * integer less than 2<font size="-1"><sup>24</sup> </font>, are * produced with (approximately) equal probability.
--- a/src/share/classes/java/util/ResourceBundle.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/util/ResourceBundle.java Tue Jan 24 00:25:46 2017 +0000 @@ -2282,9 +2282,9 @@ * is returned. And if the resource bundles for the "ja" and * "" <code>Locale</code>s are found, then the runtime resource * lookup path (parent chain) is: - * <pre> + * <pre>{@code * Messages_ja -> Messages - * </pre> + * }</pre> * * @param baseName * the base name of the resource bundle, a fully
--- a/src/share/classes/java/util/Scanner.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/util/Scanner.java Tue Jan 24 00:25:46 2017 +0000 @@ -49,47 +49,51 @@ * * <p>For example, this code allows a user to read a number from * <tt>System.in</tt>: - * <blockquote><pre> + * <blockquote><pre>{@code * Scanner sc = new Scanner(System.in); * int i = sc.nextInt(); - * </pre></blockquote> + * }</pre></blockquote> * * <p>As another example, this code allows <code>long</code> types to be * assigned from entries in a file <code>myNumbers</code>: - * <blockquote><pre> + * <blockquote><pre>{@code * Scanner sc = new Scanner(new File("myNumbers")); * while (sc.hasNextLong()) { * long aLong = sc.nextLong(); - * }</pre></blockquote> + * } + * }</pre></blockquote> * * <p>The scanner can also use delimiters other than whitespace. This * example reads several items in from a string: - *<blockquote><pre> + * <blockquote><pre>{@code * String input = "1 fish 2 fish red fish blue fish"; * Scanner s = new Scanner(input).useDelimiter("\\s*fish\\s*"); * System.out.println(s.nextInt()); * System.out.println(s.nextInt()); * System.out.println(s.next()); * System.out.println(s.next()); - * s.close(); </pre></blockquote> + * s.close(); + * }</pre></blockquote> * <p> * prints the following output: - * <blockquote><pre> + * <blockqjote><pre>{@code * 1 * 2 * red - * blue </pre></blockquote> + * blue + * }</pre></blockquote> * * <p>The same output can be generated with this code, which uses a regular * expression to parse all four tokens at once: - *<blockquote><pre> + * <blockquote><pre>{@code * String input = "1 fish 2 fish red fish blue fish"; * Scanner s = new Scanner(input); * s.findInLine("(\\d+) fish (\\d+) fish (\\w+) fish (\\w+)"); * MatchResult result = s.match(); * for (int i=1; i<=result.groupCount(); i++) * System.out.println(result.group(i)); - * s.close(); </pre></blockquote> + * s.close(); + * }</pre></blockquote> * * <p>The <a name="default-delimiter">default whitespace delimiter</a> used * by a scanner is as recognized by {@link java.lang.Character}.{@link @@ -2640,11 +2644,11 @@ * <tt>scanner.reset()</tt> behaves in exactly the same way as the * invocation * - * <blockquote><pre> + * <blockquote><pre>{@code * scanner.useDelimiter("\\p{javaWhitespace}+") * .useLocale(Locale.getDefault()) * .useRadix(10); - * </pre></blockquote> + * }</pre></blockquote> * * @return this scanner *
--- a/src/share/classes/java/util/TimerTask.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/util/TimerTask.java Tue Jan 24 00:25:46 2017 +0000 @@ -130,14 +130,14 @@ * <p>This method is typically invoked from within a task's run method, to * determine whether the current execution of the task is sufficiently * timely to warrant performing the scheduled activity: - * <pre> + * <pre>{@code * public void run() { * if (System.currentTimeMillis() - scheduledExecutionTime() >= * MAX_TARDINESS) * return; // Too late; skip this execution. * // Perform the task * } - * </pre> + * }</pre> * This method is typically <i>not</i> used in conjunction with * <i>fixed-delay execution</i> repeating tasks, as their scheduled * execution times are allowed to drift over time, and so are not terribly
--- a/src/share/classes/java/util/jar/Pack200.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/util/jar/Pack200.java Tue Jan 24 00:25:46 2017 +0000 @@ -45,7 +45,7 @@ * transform the byte-stream back to JAR format. * <p> * Here is an example using packer and unpacker:<p> - * <blockquote><pre> + * <pre>{@code * import java.util.jar.Pack200; * import java.util.jar.Pack200.*; * ... @@ -90,7 +90,7 @@ * } catch (IOException ioe) { * ioe.printStackTrace(); * } - * </pre></blockquote> + * }</pre> * <p> * A Pack200 file compressed with gzip can be hosted on HTTP/1.1 web servers. * The deployment applications can use "Accept-Encoding=pack200-gzip". This
--- a/src/share/classes/java/util/logging/FileHandler.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/util/logging/FileHandler.java Tue Jan 24 00:25:46 2017 +0000 @@ -307,7 +307,7 @@ * @exception IOException if there are IO problems opening the files. * @exception SecurityException if a security manager exists and if * the caller does not have <tt>LoggingPermission("control")</tt>. - * @exception IllegalArgumentException if limit < 0, or count < 1. + * @exception IllegalArgumentException if {@code limit < 0}, or {@code count < 1}. * @exception IllegalArgumentException if pattern is an empty string */ public FileHandler(String pattern, int limit, int count) @@ -345,7 +345,7 @@ * @exception IOException if there are IO problems opening the files. * @exception SecurityException if a security manager exists and if * the caller does not have <tt>LoggingPermission("control")</tt>. - * @exception IllegalArgumentException if limit < 0, or count < 1. + * @exception IllegalArgumentException if {@code limit < 0}, or {@code count < 1}. * @exception IllegalArgumentException if pattern is an empty string * */
--- a/src/share/classes/java/util/logging/MemoryHandler.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/util/logging/MemoryHandler.java Tue Jan 24 00:25:46 2017 +0000 @@ -136,7 +136,7 @@ * @param size the number of log records to buffer (must be greater than zero) * @param pushLevel message level to push on * - * @throws IllegalArgumentException if size is <= 0 + * @throws IllegalArgumentException if {@code size is <= 0} */ public MemoryHandler(Handler target, int size, Level pushLevel) { if (target == null || pushLevel == null) {
--- a/src/share/classes/java/util/prefs/Preferences.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/util/prefs/Preferences.java Tue Jan 24 00:25:46 2017 +0000 @@ -134,52 +134,52 @@ * subsequently restore from the backup. * * <p>The XML document has the following DOCTYPE declaration: - * <pre> - * <!DOCTYPE preferences SYSTEM "http://java.sun.com/dtd/preferences.dtd"> - * </pre> + * <pre>{@code + * <!DOCTYPE preferences SYSTEM "http://java.sun.com/dtd/preferences.dtd"> + * }</pre> * Note that the system URI (http://java.sun.com/dtd/preferences.dtd) is * <i>not</i> accessed when exporting or importing preferences; it merely * serves as a string to uniquely identify the DTD, which is: - * <pre> - * <?xml version="1.0" encoding="UTF-8"?> + * <pre>{@code + * <?xml version="1.0" encoding="UTF-8"?> * - * <!-- DTD for a Preferences tree. --> + * <!-- DTD for a Preferences tree. --> * - * <!-- The preferences element is at the root of an XML document - * representing a Preferences tree. --> - * <!ELEMENT preferences (root)> + * <!-- The preferences element is at the root of an XML document + * representing a Preferences tree. --> + * <!ELEMENT preferences (root)> * - * <!-- The preferences element contains an optional version attribute, - * which specifies version of DTD. --> - * <!ATTLIST preferences EXTERNAL_XML_VERSION CDATA "0.0" > + * <!-- The preferences element contains an optional version attribute, + * which specifies version of DTD. --> + * <!ATTLIST preferences EXTERNAL_XML_VERSION CDATA "0.0" > * - * <!-- The root element has a map representing the root's preferences - * (if any), and one node for each child of the root (if any). --> - * <!ELEMENT root (map, node*) > + * <!-- The root element has a map representing the root's preferences + * (if any), and one node for each child of the root (if any). --> + * <!ELEMENT root (map, node*) > * - * <!-- Additionally, the root contains a type attribute, which - * specifies whether it's the system or user root. --> - * <!ATTLIST root - * type (system|user) #REQUIRED > + * <!-- Additionally, the root contains a type attribute, which + * specifies whether it's the system or user root. --> + * <!ATTLIST root + * type (system|user) #REQUIRED > * - * <!-- Each node has a map representing its preferences (if any), - * and one node for each child (if any). --> - * <!ELEMENT node (map, node*) > + * <!-- Each node has a map representing its preferences (if any), + * and one node for each child (if any). --> + * <!ELEMENT node (map, node*) > * - * <!-- Additionally, each node has a name attribute --> - * <!ATTLIST node - * name CDATA #REQUIRED > + * <!-- Additionally, each node has a name attribute --> + * <!ATTLIST node + * name CDATA #REQUIRED > * - * <!-- A map represents the preferences stored at a node (if any). --> - * <!ELEMENT map (entry*) > + * <!-- A map represents the preferences stored at a node (if any). --> + * <!ELEMENT map (entry*) > * - * <!-- An entry represents a single preference, which is simply - * a key-value pair. --> - * <!ELEMENT entry EMPTY > - * <!ATTLIST entry + * <!-- An entry represents a single preference, which is simply + * a key-value pair. --> + * <!ELEMENT entry EMPTY > + * <!ATTLIST entry * key CDATA #REQUIRED - * value CDATA #REQUIRED > - * </pre> + * value CDATA #REQUIRED > + * }</pre> * * Every <tt>Preferences</tt> implementation must have an associated {@link * PreferencesFactory} implementation. Every Java(TM) SE implementation must provide @@ -1164,9 +1164,9 @@ * This XML document is, in effect, an offline backup of the node. * * <p>The XML document will have the following DOCTYPE declaration: - * <pre> - * <!DOCTYPE preferences SYSTEM "http://java.sun.com/dtd/preferences.dtd"> - * </pre> + * <pre>{@code + * <!DOCTYPE preferences SYSTEM "http://java.sun.com/dtd/preferences.dtd"> + * }</pre> * The UTF-8 character encoding will be used. * * <p>This method is an exception to the general rule that the results of @@ -1195,9 +1195,9 @@ * effect, an offline backup of the subtree rooted at the node. * * <p>The XML document will have the following DOCTYPE declaration: - * <pre> - * <!DOCTYPE preferences SYSTEM "http://java.sun.com/dtd/preferences.dtd"> - * </pre> + * <pre>{@code + * <!DOCTYPE preferences SYSTEM "http://java.sun.com/dtd/preferences.dtd"> + * }</pre> * The UTF-8 character encoding will be used. * * <p>This method is an exception to the general rule that the results of @@ -1231,9 +1231,9 @@ * do not exist, the nodes will be created. * * <p>The XML document must have the following DOCTYPE declaration: - * <pre> - * <!DOCTYPE preferences SYSTEM "http://java.sun.com/dtd/preferences.dtd"> - * </pre> + * <pre>{@code + * <!DOCTYPE preferences SYSTEM "http://java.sun.com/dtd/preferences.dtd"> + * }</pre> * (This method is designed for use in conjunction with * {@link #exportNode(OutputStream)} and * {@link #exportSubtree(OutputStream)}.
--- a/src/share/classes/java/util/regex/MatchResult.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/util/regex/MatchResult.java Tue Jan 24 00:25:46 2017 +0000 @@ -79,7 +79,7 @@ /** * Returns the offset after the last character matched. </p> * - * @return @return The offset after the last character matched + * @return The offset after the last character matched * * @throws IllegalStateException * If no match has yet been attempted,
--- a/src/share/classes/java/util/regex/Pattern.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/util/regex/Pattern.java Tue Jan 24 00:25:46 2017 +0000 @@ -104,7 +104,7 @@ * <tr><td valign="top" headers="construct characters"><tt>\x</tt><i>{h...h}</i></td> * <td headers="matches">The character with hexadecimal value <tt>0x</tt><i>h...h</i> * ({@link java.lang.Character#MIN_CODE_POINT Character.MIN_CODE_POINT} - * <= <tt>0x</tt><i>h...h</i> <=  + * <= <tt>0x</tt><i>h...h</i> <= * {@link java.lang.Character#MAX_CODE_POINT Character.MAX_CODE_POINT})</td></tr> * <tr><td valign="top" headers="matches"><tt>\t</tt></td> * <td headers="matches">The tab character (<tt>'\u0009'</tt>)</td></tr>
--- a/src/share/classes/java/util/zip/DeflaterInputStream.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/util/zip/DeflaterInputStream.java Tue Jan 24 00:25:46 2017 +0000 @@ -97,7 +97,7 @@ * @param in input stream to read the uncompressed data to * @param defl compressor ("deflater") for this stream * @param bufLen compression buffer size - * @throws IllegalArgumentException if {@code bufLen} is <= 0 + * @throws IllegalArgumentException if {@code bufLen <= 0} * @throws NullPointerException if {@code in} or {@code defl} is null */ public DeflaterInputStream(InputStream in, Deflater defl, int bufLen) { @@ -163,8 +163,7 @@ * @param len maximum number of compressed bytes to read into {@code b} * @return the actual number of bytes read, or -1 if the end of the * uncompressed input stream is reached - * @throws IndexOutOfBoundsException if {@code len} > {@code b.length - - * off} + * @throws IndexOutOfBoundsException if {@code len > b.length - off} * @throws IOException if an I/O error occurs or if this input stream is * already closed */
--- a/src/share/classes/java/util/zip/DeflaterOutputStream.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/util/zip/DeflaterOutputStream.java Tue Jan 24 00:25:46 2017 +0000 @@ -71,7 +71,7 @@ * {@link Deflater#SYNC_FLUSH} before flushing the output * stream, otherwise only flushes the output stream * - * @throws IllegalArgumentException if size is <= 0 + * @throws IllegalArgumentException if {@code size <= 0} * * @since 1.7 */ @@ -101,7 +101,7 @@ * @param out the output stream * @param def the compressor ("deflater") * @param size the output buffer size - * @exception IllegalArgumentException if size is <= 0 + * @exception IllegalArgumentException if {@code size <= 0} */ public DeflaterOutputStream(OutputStream out, Deflater def, int size) { this(out, def, size, false);
--- a/src/share/classes/java/util/zip/GZIPInputStream.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/util/zip/GZIPInputStream.java Tue Jan 24 00:25:46 2017 +0000 @@ -70,7 +70,7 @@ * @exception ZipException if a GZIP format error has occurred or the * compression method used is unsupported * @exception IOException if an I/O error has occurred - * @exception IllegalArgumentException if size is <= 0 + * @exception IllegalArgumentException if {@code size <= 0} */ public GZIPInputStream(InputStream in, int size) throws IOException { super(in, new Inflater(true), size);
--- a/src/share/classes/java/util/zip/GZIPOutputStream.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/util/zip/GZIPOutputStream.java Tue Jan 24 00:25:46 2017 +0000 @@ -61,8 +61,7 @@ * @param out the output stream * @param size the output buffer size * @exception IOException If an I/O error has occurred. - * @exception IllegalArgumentException if size is <= 0 - + * @exception IllegalArgumentException if {@code size <= 0} */ public GZIPOutputStream(OutputStream out, int size) throws IOException { this(out, size, false); @@ -81,7 +80,7 @@ * {@link Deflater#SYNC_FLUSH} before flushing the output * stream, otherwise only flushes the output stream * @exception IOException If an I/O error has occurred. - * @exception IllegalArgumentException if size is <= 0 + * @exception IllegalArgumentException if {@code size <= 0} * * @since 1.7 */
--- a/src/share/classes/java/util/zip/InflaterInputStream.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/util/zip/InflaterInputStream.java Tue Jan 24 00:25:46 2017 +0000 @@ -75,7 +75,7 @@ * @param in the input stream * @param inf the decompressor ("inflater") * @param size the input buffer size - * @exception IllegalArgumentException if size is <= 0 + * @exception IllegalArgumentException if {@code size <= 0} */ public InflaterInputStream(InputStream in, Inflater inf, int size) { super(in); @@ -191,7 +191,7 @@ * @param n the number of bytes to skip * @return the actual number of bytes skipped. * @exception IOException if an I/O error has occurred - * @exception IllegalArgumentException if n < 0 + * @exception IllegalArgumentException if {@code n < 0} */ public long skip(long n) throws IOException { if (n < 0) {
--- a/src/share/classes/java/util/zip/InflaterOutputStream.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/util/zip/InflaterOutputStream.java Tue Jan 24 00:25:46 2017 +0000 @@ -97,7 +97,7 @@ * @param out output stream to write the uncompressed data to * @param infl decompressor ("inflater") for this stream * @param bufLen decompression buffer size - * @throws IllegalArgumentException if {@code bufLen} is <= 0 + * @throws IllegalArgumentException if {@code bufLen <= 0} * @throws NullPointerException if {@code out} or {@code infl} is null */ public InflaterOutputStream(OutputStream out, Inflater infl, int bufLen) { @@ -211,8 +211,8 @@ * the output stream * @param off starting offset of the compressed data within {@code b} * @param len number of bytes to decompress from {@code b} - * @throws IndexOutOfBoundsException if {@code off} < 0, or if - * {@code len} < 0, or if {@code len} > {@code b.length - off} + * @throws IndexOutOfBoundsException if {@code off < 0}, or if + * {@code len < 0}, or if {@code len > b.length - off} * @throws IOException if an I/O error occurs or this stream is already * closed * @throws NullPointerException if {@code b} is null
--- a/src/share/classes/java/util/zip/ZipInputStream.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/java/util/zip/ZipInputStream.java Tue Jan 24 00:25:46 2017 +0000 @@ -231,7 +231,7 @@ * @return the actual number of bytes skipped * @exception ZipException if a ZIP file error has occurred * @exception IOException if an I/O error has occurred - * @exception IllegalArgumentException if n < 0 + * @exception IllegalArgumentException if {@code n < 0} */ public long skip(long n) throws IOException { if (n < 0) {
--- a/src/share/classes/javax/crypto/spec/IvParameterSpec.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/crypto/spec/IvParameterSpec.java Tue Jan 24 00:25:46 2017 +0000 @@ -68,7 +68,7 @@ * starts. * @param len the number of IV bytes. * @throws IllegalArgumentException if <code>iv</code> is <code>null</code> - * or <code>(iv.length - offset < len)</code> + * or {@code (iv.length - offset < len)} * @throws ArrayIndexOutOfBoundsException is thrown if <code>offset</code> * or <code>len</code> index bytes outside the <code>iv</code>. */
--- a/src/share/classes/javax/crypto/spec/RC5ParameterSpec.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/crypto/spec/RC5ParameterSpec.java Tue Jan 24 00:25:46 2017 +0000 @@ -80,7 +80,7 @@ * </code> bytes of the buffer are copied to protect against subsequent * modification. * @exception IllegalArgumentException if <code>iv</code> is - * <code>null</code> or <code>(iv.length < 2 * (wordSize / 8))</code> + * <code>null</code> or {@code (iv.length < 2 * (wordSize / 8))} */ public RC5ParameterSpec(int version, int rounds, int wordSize, byte[] iv) { this(version, rounds, wordSize, iv, 0); @@ -107,7 +107,7 @@ * @param offset the offset in <code>iv</code> where the IV starts. * @exception IllegalArgumentException if <code>iv</code> is * <code>null</code> or - * <code>(iv.length - offset < 2 * (wordSize / 8))</code> + * {@code (iv.length - offset < 2 * (wordSize / 8))} */ public RC5ParameterSpec(int version, int rounds, int wordSize, byte[] iv, int offset) {
--- a/src/share/classes/javax/crypto/spec/SecretKeySpec.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/crypto/spec/SecretKeySpec.java Tue Jan 24 00:25:46 2017 +0000 @@ -131,7 +131,7 @@ * for information about standard algorithm names. * @exception IllegalArgumentException if <code>algorithm</code> * is null or <code>key</code> is null, empty, or too short, - * i.e. <code>key.length-offset<len</code>. + * i.e. {@code key.length-offset<len}. * @exception ArrayIndexOutOfBoundsException is thrown if * <code>offset</code> or <code>len</code> index bytes outside the * <code>key</code>.
--- a/src/share/classes/javax/naming/BinaryRefAddr.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/naming/BinaryRefAddr.java Tue Jan 24 00:25:46 2017 +0000 @@ -89,9 +89,9 @@ * @param src The non-null contents of the address as a byte array. * The contents of src is copied into the new BinaryRefAddr. * @param offset The starting index in src to get the bytes. - * 0 <= offset <= src.length. + * {@code 0 <= offset <= src.length}. * @param count The number of bytes to extract from src. - * 0 <= count <= src.length-offset. + * {@code 0 <= count <= src.length-offset}. */ public BinaryRefAddr(String addrType, byte[] src, int offset, int count) { super(addrType);
--- a/src/share/classes/javax/naming/directory/Attribute.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/naming/directory/Attribute.java Tue Jan 24 00:25:46 2017 +0000 @@ -265,7 +265,7 @@ * If the attribute values are unordered, * this method returns the value that happens to be at that index. * @param ix The index of the value in the ordered list of attribute values. - * 0 <= <tt>ix</tt> < <tt>size()</tt>. + * {@code 0 <= ix < size()}. * @return The possibly null attribute value at index <tt>ix</tt>; * null if the attribute value is null. * @exception NamingException If a naming exception was encountered while @@ -284,7 +284,7 @@ * the front of the list (and their indices decremented by one). * * @param ix The index of the value to remove. - * 0 <= <tt>ix</tt> < <tt>size()</tt>. + * {@code 0 <= ix < size()}. * @return The possibly null attribute value at index <tt>ix</tt> that was removed; * null if the attribute value is null. * @exception IndexOutOfBoundsException If <tt>ix</tt> is outside the specified range. @@ -302,7 +302,7 @@ * <tt>IllegalStateException</tt> is thrown. * * @param ix The index in the ordered list of attribute values to add the new value. - * 0 <= <tt>ix</tt> <= <tt>size()</tt>. + * {@code 0 <= ix <= size()}. * @param attrVal The possibly null attribute value to add; if null, null is * the value added. * @exception IndexOutOfBoundsException If <tt>ix</tt> is outside the specified range. @@ -322,7 +322,7 @@ * In that case, <tt>IllegalStateException</tt> is thrown. * * @param ix The index of the value in the ordered list of attribute values. - * 0 <= <tt>ix</tt> < <tt>size()</tt>. + * {@code 0 <= ix < size()}. * @param attrVal The possibly null attribute value to use. * If null, 'null' replaces the old value. * @return The possibly null attribute value at index ix that was replaced.
--- a/src/share/classes/javax/naming/ldap/LdapName.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/naming/ldap/LdapName.java Tue Jan 24 00:25:46 2017 +0000 @@ -447,7 +447,7 @@ * @throws InvalidNameException if <tt>suffix</tt> is not a valid LDAP * name, or if the addition of the components would violate the * syntax rules of this LDAP name. - * @throws IndexOutOfBoundsException. + * @throws IndexOutOfBoundsException * If posn is outside the specified range. */ public Name addAll(int posn, Name suffix) @@ -478,7 +478,7 @@ * Must be in the range [0,size()]. * * @return The updated name (not a new instance). - * @throws IndexOutOfBoundsException. + * @throws IndexOutOfBoundsException * If posn is outside the specified range. */ public Name addAll(int posn, List<Rdn> suffixRdns) { @@ -531,7 +531,7 @@ * Must be in the range [0,size()]. * @return The updated LdapName, not a new instance. * Cannot be null. - * @exception IndexOutOfBoundsException. + * @exception IndexOutOfBoundsException * If posn is outside the specified range. * @exception InvalidNameException If adding comp at the * specified position would violate the name's syntax.
--- a/src/share/classes/javax/naming/ldap/PagedResultsControl.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/naming/ldap/PagedResultsControl.java Tue Jan 24 00:25:46 2017 +0000 @@ -36,7 +36,7 @@ * at which it invokes search operations. * <p> * The following code sample shows how the class may be used: - * <pre> + * <pre>{@code * * // Open an LDAP association * LdapContext ctx = new InitialLdapContext(); @@ -89,13 +89,13 @@ * ctx.close(); * ... * - * </pre> + * } </pre> * <p> * This class implements the LDAPv3 Control for paged-results as defined in * <a href="http://www.ietf.org/rfc/rfc2696.txt">RFC 2696</a>. * * The control's value has the following ASN.1 definition: - * <pre> + * <pre>{@code * * realSearchControlValue ::= SEQUENCE { * size INTEGER (0..maxInt), @@ -104,7 +104,7 @@ * cookie OCTET STRING * } * - * </pre> + * }</pre> * * @since 1.5 * @see PagedResultsResponseControl
--- a/src/share/classes/javax/naming/ldap/SortControl.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/naming/ldap/SortControl.java Tue Jan 24 00:25:46 2017 +0000 @@ -40,7 +40,7 @@ * then the search operation is not performed and an error is returned. * <p> * The following code sample shows how the class may be used: - * <pre> + * <pre>{@code * * // Open an LDAP association * LdapContext ctx = new InitialLdapContext(); @@ -85,7 +85,7 @@ * ctx.close(); * ... * - * </pre> + * }</pre> * <p> * This class implements the LDAPv3 Request Control for server-side sorting * as defined in
--- a/src/share/classes/javax/net/ssl/SSLEngine.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/net/ssl/SSLEngine.java Tue Jan 24 00:25:46 2017 +0000 @@ -211,7 +211,7 @@ * that the source buffer has enough room to hold a record (enlarging if * necessary), and then obtain more inbound data. * - * <pre> + * <pre>{@code * SSLEngineResult r = engine.unwrap(src, dst); * switch (r.getStatus()) { * BUFFER_OVERFLOW: @@ -238,7 +238,7 @@ * break; * // other cases: CLOSED, OK. * } - * </pre> + * }</pre> * * <P> * Unlike <code>SSLSocket</code>, all methods of SSLEngine are @@ -442,7 +442,7 @@ * <blockquote><pre> * {@link #wrap(ByteBuffer [], int, int, ByteBuffer) * engine.wrap(new ByteBuffer [] { src }, 0, 1, dst);} - * </pre</blockquote> + * </pre></blockquote> * * @param src * a <code>ByteBuffer</code> containing outbound application data @@ -478,7 +478,7 @@ * <blockquote><pre> * {@link #wrap(ByteBuffer [], int, int, ByteBuffer) * engine.wrap(srcs, 0, srcs.length, dst);} - * </pre</blockquote> + * </pre></blockquote> * * @param srcs * an array of <code>ByteBuffers</code> containing the @@ -597,7 +597,7 @@ * <blockquote><pre> * {@link #unwrap(ByteBuffer, ByteBuffer [], int, int) * engine.unwrap(src, new ByteBuffer [] { dst }, 0, 1);} - * </pre</blockquote> + * </pre></blockquote> * * @param src * a <code>ByteBuffer</code> containing inbound network data. @@ -633,7 +633,7 @@ * <blockquote><pre> * {@link #unwrap(ByteBuffer, ByteBuffer [], int, int) * engine.unwrap(src, dsts, 0, dsts.length);} - * </pre</blockquote> + * </pre></blockquote> * * @param src * a <code>ByteBuffer</code> containing inbound network data.
--- a/src/share/classes/javax/net/ssl/SSLEngineResult.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/net/ssl/SSLEngineResult.java Tue Jan 24 00:25:46 2017 +0000 @@ -173,7 +173,7 @@ * * @throws IllegalArgumentException * if the <code>status</code> or <code>handshakeStatus</code> - * arguments are null, or if <<code>bytesConsumed</code> or + * arguments are null, or if <code>bytesConsumed</code> or * <code>bytesProduced</code> is negative. */ public SSLEngineResult(Status status, HandshakeStatus handshakeStatus,
--- a/src/share/classes/javax/net/ssl/SSLSessionContext.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/net/ssl/SSLSessionContext.java Tue Jan 24 00:25:46 2017 +0000 @@ -90,7 +90,7 @@ * @param seconds the new session timeout limit in seconds; zero means * there is no limit. * - * @exception IllegalArgumentException if the timeout specified is < 0. + * @exception IllegalArgumentException if the timeout specified is {@code < 0}. * @see #getSessionTimeout */ public void setSessionTimeout(int seconds) @@ -122,7 +122,7 @@ * * @param size the new session cache size limit; zero means there is no * limit. - * @exception IllegalArgumentException if the specified size is < 0. + * @exception IllegalArgumentException if the specified size is {@code < 0}. * @see #getSessionCacheSize */ public void setSessionCacheSize(int size)
--- a/src/share/classes/javax/script/ScriptEngineFactory.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/script/ScriptEngineFactory.java Tue Jan 24 00:25:46 2017 +0000 @@ -144,8 +144,7 @@ * of the supported scripting language. For instance, an implementaton for a Javascript * engine might be; * <p> - * <pre> - * <code> + * <pre>{@code * public String getMethodCallSyntax(String obj, * String m, String... args) { * String ret = obj; @@ -159,8 +158,7 @@ * ret += ")"; * return ret; * } - *</code> - *</pre> + * } </pre> * <p> * * @param obj The name representing the object whose method is to be invoked. The @@ -200,17 +198,17 @@ * Returns A valid scripting language executable progam with given statements. * For instance an implementation for a PHP engine might be: * <p> - * <pre><code> + * <pre>{@code * public String getProgram(String... statements) { - * $retval = "<?\n"; + * $retval = "<?\n"; * int len = statements.length; * for (int i = 0; i < len; i++) { * $retval += statements[i] + ";\n"; * } - * $retval += "?>"; + * $retval += "?>"; * * } - * </code></pre> + * }</pre> * * @param statements The statements to be executed. May be return values of * calls to the <code>getMethodCallSyntax</code> and <code>getOutputStatement</code> methods.
--- a/src/share/classes/javax/security/auth/callback/CallbackHandler.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/security/auth/callback/CallbackHandler.java Tue Jan 24 00:25:46 2017 +0000 @@ -82,7 +82,7 @@ * This example code is for guidance only. Many details, * including proper error handling, are left out for simplicity. * - * <pre> + * <pre>{@code * public void handle(Callback[] callbacks) * throws IOException, UnsupportedCallbackException { * @@ -136,7 +136,7 @@ * private char[] readPassword(InputStream in) throws IOException { * // insert code to read a user password from the input stream * } - * </pre> + * }</pre> * * @param callbacks an array of {@code Callback} objects provided * by an underlying security service which contains
--- a/src/share/classes/javax/security/sasl/Sasl.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/security/sasl/Sasl.java Tue Jan 24 00:25:46 2017 +0000 @@ -266,7 +266,7 @@ * * This method uses the <a href="{@docRoot}/../technotes/guides/security/crypto/CryptoSpec.html#Provider">JCA Security Provider Framework</a>, described in the - * "Java Cryptography Architecture API Specification & Reference", for + * "Java Cryptography Architecture API Specification & Reference", for * locating and selecting a {@code SaslClient} implementation. * * First, it @@ -291,7 +291,7 @@ * {@code SaslClientFactory.DIGEST-MD5 com.wiz.sasl.digest.ClientFactory} *<p> * See the - * "Java Cryptography Architecture API Specification & Reference" + * "Java Cryptography Architecture API Specification & Reference" * for information about how to install and configure security service * providers. * @@ -416,7 +416,7 @@ * This method uses the <a href="{@docRoot}/../technotes/guides/security/crypto/CryptoSpec.html#Provider">JCA Security Provider Framework</a>, * described in the - * "Java Cryptography Architecture API Specification & Reference", for + * "Java Cryptography Architecture API Specification & Reference", for * locating and selecting a {@code SaslServer} implementation. * * First, it @@ -441,7 +441,7 @@ * {@code SaslServerFactory.DIGEST-MD5 com.wiz.sasl.digest.ServerFactory} *<p> * See the - * "Java Cryptography Architecture API Specification & Reference" + * "Java Cryptography Architecture API Specification & Reference" * for information about how to install and configure security * service providers. *
--- a/src/share/classes/javax/security/sasl/SaslClient.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/security/sasl/SaslClient.java Tue Jan 24 00:25:46 2017 +0000 @@ -38,13 +38,13 @@ *<p> * Here's an example of how an LDAP library might use a {@code SaslClient}. * It first gets an instance of a {@code SaslClient}: - *<blockquote><pre> + *<blockquote><pre>{@code * SaslClient sc = Sasl.createSaslClient(mechanisms, * authorizationId, protocol, serverName, props, callbackHandler); - *</pre></blockquote> + *}</pre></blockquote> * It can then proceed to use the client for authentication. * For example, an LDAP library might use the client as follows: - *<blockquote><pre> + *<blockquote><pre>{@code * // Get initial response and send to server * byte[] response = (sc.hasInitialResponse() ? sc.evaluateChallenge(new byte[0]) : * null); @@ -74,7 +74,7 @@ * ldap.out = new SecureOutputStream(sc, ldap.out); * } * } - *</pre></blockquote> + *}</pre></blockquote> * * If the mechanism has an initial response, the library invokes * {@code evaluateChallenge()} with an empty
--- a/src/share/classes/javax/security/sasl/SaslServer.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/security/sasl/SaslServer.java Tue Jan 24 00:25:46 2017 +0000 @@ -47,7 +47,7 @@ * For example, suppose the LDAP server received an LDAP BIND request * containing the name of the SASL mechanism and an (optional) initial * response. It then might use the server as follows: - *<blockquote><pre> + *<blockquote><pre>{@code * while (!ss.isComplete()) { * try { * byte[] challenge = ss.evaluateResponse(response); @@ -75,7 +75,7 @@ * ldap.out = new SecureOutputStream(ss, ldap.out); * } * } - *</pre></blockquote> + *}</pre></blockquote> * * @since 1.5 *
--- a/src/share/classes/javax/smartcardio/ResponseAPDU.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/smartcardio/ResponseAPDU.java Tue Jan 24 00:25:46 2017 +0000 @@ -121,7 +121,7 @@ * Returns the value of the status bytes SW1 and SW2 as a single * status word SW. * It is defined as - * <code>(getSW1() << 8) | getSW2()</code>. + * {@code (getSW1() << 8) | getSW2()} * * @return the value of the status word SW. */
--- a/src/share/classes/javax/sql/rowset/BaseRowSet.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/sql/rowset/BaseRowSet.java Tue Jan 24 00:25:46 2017 +0000 @@ -109,10 +109,10 @@ * <code>CachedRowSet</code><sup><font size=-2>TM</font></sup> * object <code>crs</code> might have its command property set. Note that if a * tool is used to set properties, this is the code that the tool would use. - * <PRE> + * <PRE>{@code * crs.setCommand("SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS" + * "WHERE CREDIT_LIMIT > ? AND REGION = ?"); - * </PRE> + * }</PRE> * <P> * In this example, the values for <code>CREDIT_LIMIT</code> and * <code>REGION</code> are placeholder parameters, which are indicated with a @@ -129,16 +129,16 @@ * <P> * The following code fragment demonstrates * setting the two parameters in the query from the previous example. - * <PRE> + * <PRE>{@code * crs.setInt(1, 5000); * crs.setString(2, "West"); - * </PRE> + * }</PRE> * If the <code>execute</code> method is called at this point, the query * sent to the DBMS will be: - * <PRE> + * <PRE>{@code * "SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS" + * "WHERE CREDIT_LIMIT > 5000 AND REGION = 'West'" - * </PRE> + * }</PRE> * NOTE: Setting <code>Array</code>, <code>Clob</code>, <code>Blob</code> and * <code>Ref</code> objects as a command parameter, stores these values as * <code>SerialArray</code>, <code>SerialClob</code>, <code>SerialBlob</code> @@ -158,7 +158,7 @@ * When the method <code>execute</code> is called, the values in the * <code>Hashtable</code> object are substituted for the appropriate placeholder * parameters in the command. - * <P)> + * <P> * A call to the method <code>getParams</code> returns the values stored in the * <code>Hashtable</code> object as an array of <code>Object</code> instances. * An element in this array may be a simple <code>Object</code> instance or an @@ -2535,7 +2535,7 @@ * specific abstract data types. * <P> * The parameter value set by this method is stored internally and - * will be supplied as the appropriate parameter in this <code>RowSet</code + * will be supplied as the appropriate parameter in this <code>RowSet</code> * object's command when the method <code>execute</code> is called. * Methods such as <code>execute</code> and <code>populate</code> must be * provided in any class that extends this class and implements one or
--- a/src/share/classes/javax/sql/rowset/CachedRowSet.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/sql/rowset/CachedRowSet.java Tue Jan 24 00:25:46 2017 +0000 @@ -118,7 +118,7 @@ * <P> * There are two ways for a <code>CachedRowSet</code> object to specify which * <code>SyncProvider</code> object it will use. - * <UL) + * <UL> * <LI>Supplying the name of the implementation to the constructor<BR> * The following line of code creates the <code>CachedRowSet</code> * object <i>crs2</i> that is initialized with default values except that its @@ -135,7 +135,7 @@ * <PRE> * crs.setSyncProvider("com.fred.providers.HighAvailabilityProvider"); * </PRE> - * </UL) + * </UL> * See the comments for <code>SyncFactory</code> and <code>SyncProvider</code> for * more details. * @@ -426,10 +426,10 @@ * The following code fragment illustrates how the <code>CachedRowSet</code> * object <code>crs</code> might have its command property set. Note that if a * tool is used to set properties, this is the code that the tool would use. - * <PRE> + * <PRE>{@code * crs.setCommand("SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS " + * "WHERE CREDIT_LIMIT > ? AND REGION = ?"); - * </PRE> + * } </PRE> * <P> * The values that will be used to set the command's placeholder parameters are * contained in the <code>RowSet</code> object's <code>params</code> field, which is a @@ -457,7 +457,7 @@ * The following code fragment gives an idea of how the reader * does this, after obtaining the <code>Connection</code> object * <code>con</code>. - * <PRE> + * <PRE>{@code * PreparedStatement pstmt = con.prepareStatement(crs.getCommand()); * reader.decodeParams(); * // decodeParams figures out which setter methods to use and does something @@ -465,16 +465,16 @@ * // for (i = 0; i < params.length; i++) { * // pstmt.setObject(i + 1, params[i]); * // } - * </PRE> + * }</PRE> * <P> - * At this point, the command for <code>crs</code> is the query <code>"SELECT + * At this point, the command for <code>crs</code> is the query {@code "SELECT * FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS WHERE CREDIT_LIMIT > 5000 - * AND REGION = "West"</code>. After the <code>readData</code> method executes + * AND REGION = "West"}. After the <code>readData</code> method executes * this command with the following line of code, it will have the data from * <code>rs</code> with which to populate <code>crs</code>. - * <PRE> + * <PRE>{@code * ResultSet rs = pstmt.executeQuery(); - * </PRE> + * }</PRE> * <P> * The preceding code fragments give an idea of what goes on behind the * scenes; they would not appear in an application, which would not invoke @@ -484,13 +484,13 @@ * the command. Simply by calling the <code>execute</code> method, * <code>crs</code> populates itself with the requested data from the * table <code>CUSTOMERS</code>. - * <PRE> + * <PRE>{@code * crs.setCommand("SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS" + * "WHERE CREDIT_LIMIT > ? AND REGION = ?"); * crs.setInt(1, 5000); * crs.setString(2, "West"); * crs.execute(); - * </PRE> + * }</PRE> * * <h3>10.0 Paging Data</h3> * Because a <code>CachedRowSet</code> object stores data in memory,
--- a/src/share/classes/javax/sql/rowset/Predicate.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/sql/rowset/Predicate.java Tue Jan 24 00:25:46 2017 +0000 @@ -53,8 +53,7 @@ * and application motivated implementations of <code>Predicate</code> to emerge. * <p> * A sample implementation would look something like this: - * <pre> - * <code> + * <pre>{@code * public class Range implements Predicate { * * private Object lo[]; @@ -79,19 +78,19 @@ * if ((rs.getObject(idx[i]) >= lo[i]) && * (rs.getObject(idx[i]) >= hi[i]) { * bool1 = true; // within filter constraints + * } else { + * bool2 = true; // outside of filter constraints + * } + * } + * + * if (bool2) { + * return false; * } else { - * bool2 = true; // outside of filter constraints + * return true; * } * } - * - * if (bool2) { - * return false; - * } else { - * return true; - * } * } - * </code> - * </pre> + * }</pre> * <P> * The example above implements a simple range predicate. Note, that * implementations should but are not required to provider <code>String</code>
--- a/src/share/classes/javax/sql/rowset/RowSetMetaDataImpl.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/sql/rowset/RowSetMetaDataImpl.java Tue Jan 24 00:25:46 2017 +0000 @@ -159,7 +159,7 @@ * @param property <code>true</code> if the given column is * automatically incremented; <code>false</code> * otherwise - * @throws <code>SQLException</code> if a database access error occurs or + * @throws SQLException if a database access error occurs or * the given index is out of bounds */ public void setAutoIncrement(int columnIndex, boolean property) throws SQLException { @@ -195,7 +195,7 @@ * value can be used in a <code>WHERE</code> clause; * <code>false</code> otherwise * - * @throws <code>SQLException</code> if a database access error occurs or + * @throws SQLException if a database access error occurs or * the given column number is out of bounds */ public void setSearchable(int columnIndex, boolean property) @@ -212,7 +212,7 @@ * must be between <code>1</code> and the number of columns, * inclusive between <code>1</code> and the number of columns, inclusive * @param property true if the value is a cash value; false otherwise. - * @throws <code>SQLException</code> if a database access error occurs + * @throws SQLException if a database access error occurs * or the given column number is out of bounds */ public void setCurrency(int columnIndex, boolean property) @@ -233,7 +233,7 @@ * <code>columnNullable</code>, or * <code>columnNullableUnknown</code> * - * @throws <code>SQLException</code> if a database access error occurs, + * @throws SQLException if a database access error occurs, * the given column number is out of bounds, or the value supplied * for the <i>property</i> parameter is not one of the following * constants:
--- a/src/share/classes/javax/sql/rowset/spi/SyncFactory.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/sql/rowset/spi/SyncFactory.java Tue Jan 24 00:25:46 2017 +0000 @@ -690,8 +690,6 @@ * required * @throws java.lang.SecurityException if a security manager exists and its * {@code checkPermission} method denies calling {@code setLogger} - * @throws java.util.logging.LoggingPermission if a security manager exists and its - * {@code checkPermission} method denies calling {@code setLevel} * @throws NullPointerException if the logger is null * @see SecurityManager#checkPermission * @see LoggingPermission
--- a/src/share/classes/javax/sql/rowset/spi/SyncResolver.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/sql/rowset/spi/SyncResolver.java Tue Jan 24 00:25:46 2017 +0000 @@ -193,7 +193,7 @@ * code fragment, the value in <i>crs</i> is the one set as the resolved value, which means * that it will be used to overwrite the conflict value in the data source. * - * <PRE> + * <PRE>{@code * try { * * crs.acceptChanges(con); @@ -202,8 +202,8 @@ * * SyncResolver resolver = spe.getSyncResolver(); * - * Object crsValue; // value in the <code>RowSet</code> object - * Object resolverValue: // value in the <code>SyncResolver</code> object + * Object crsValue; // value in the RowSet object + * Object resolverValue: // value in the SyncResolver object * Object resolvedValue: // value to be persisted * * while(resolver.nextConflict()) { @@ -227,7 +227,7 @@ * } * } * } - * </PRE> + * }</PRE> * @author Jonathan Bruce */
--- a/src/share/classes/javax/xml/crypto/dsig/Manifest.java Wed Jul 06 11:08:20 2011 -0400 +++ b/src/share/classes/javax/xml/crypto/dsig/Manifest.java Tue Jan 24 00:25:46 2017 +0000 @@ -35,15 +35,15 @@ * the <a href="http://www.w3.org/TR/xmldsig-core/"> * W3C Recommendation for XML-Signature Syntax and Processing</a>. * The XML Schema Definition is defined as: - * <pre><code> - * <element name="Manifest" type="ds:ManifestType"/> - * <complexType name="ManifestType"> - * <sequence> - * <element ref="ds:Reference" maxOccurs="unbounded"/> - * </sequence> - * <attribute name="Id" type="ID" use="optional"/> - * </complexType> - * </code></pre> + * <pre>{@code + * <element name="Manifest" type="ds:ManifestType"/> + * <complexType name="ManifestType"> + * <sequence> + * <element ref="ds:Reference" maxOccurs="unbounded"/> + * </sequence> + * <attribute name="Id" type="ID" use="optional"/> + * </complexType> + * }</pre> * * A <code>Manifest</code> instance may be created by invoking * one of the {@link XMLSignatureFactory#newManifest newManifest}