JDK 8 request for review: doclint fixes for some package-info files
Joe Darcy
joe.darcy at oracle.com
Fri Jul 19 06:38:36 UTC 2013
Hello,
A few more doclint issues, this time in package-info.java files, will be
resolved by the patch below.
Thanks,
-Joe
/*
- * Copyright (c) 2007, 2011, Oracle and/or its affiliates. All rights
reserved.
+ * Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights
reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -27,7 +27,7 @@
* Interfaces and classes providing access to file and file system
attributes.
*
* <blockquote><table cellspacing=1 cellpadding=0 summary="Attribute
views">
- * <tr><th><p align="left">Attribute views</p></th><th><p
align="left">Description</p></th></tr>
+ * <tr><th align="left">Attribute views</th><th
align="left">Description</th></tr>
* <tr><td valign=top><tt><i>{@link
java.nio.file.attribute.AttributeView}</i></tt></td>
* <td>Can read or update non-opaque values associated with
objects in a file system</td></tr>
* <tr><td valign=top><tt> <i>{@link
java.nio.file.attribute.FileAttributeView}</i></tt></td>
@@ -38,7 +38,7 @@
* <td>Can read or update POSIX defined file attributes</td></tr>
* <tr><td
valign=top><tt> <i>{@link
java.nio.file.attribute.DosFileAttributeView} </i></tt></td>
* <td>Can read or update FAT file attributes</td></tr>
- * <tr><td valign=top><tt>  <i>{@link
java.nio.file.attribute.FileOwnerAttributeView} </i></tt></td>
+ * <tr><td valign=top><tt> <i>{@link
java.nio.file.attribute.FileOwnerAttributeView} </i></tt></td>
* <td>Can read or update the owner of a file</td></tr>
* <tr><td valign=top><tt> <i>{@link
java.nio.file.attribute.AclFileAttributeView} </i></tt></td>
* <td>Can read or update Access Control Lists</td></tr>
@@ -86,14 +86,14 @@
*
* <ul>
*
- * <p><li> The {@link java.nio.file.attribute.UserPrincipal} and
+ * <li> The {@link java.nio.file.attribute.UserPrincipal} and
* {@link java.nio.file.attribute.GroupPrincipal} interfaces
represent an
* identity or group identity. </li>
*
- * <p><li> The {@link java.nio.file.attribute.UserPrincipalLookupService}
+ * <li> The {@link java.nio.file.attribute.UserPrincipalLookupService}
* interface defines methods to lookup user or group principals. </li>
*
- * <p><li> The {@link java.nio.file.attribute.FileAttribute} interface
+ * <li> The {@link java.nio.file.attribute.FileAttribute} interface
* represents the value of an attribute for cases where the
attribute value is
* required to be set atomically when creating an object in the file
system. </li>
*
diff -r 2323b973adaa src/share/classes/java/util/function/package-info.java
--- a/src/share/classes/java/util/function/package-info.java Thu Jul
18 23:16:52 2013 -0700
+++ b/src/share/classes/java/util/function/package-info.java Thu Jul
18 23:37:48 2013 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights
reserved.
+ * Copyright (c) 2011, 2013, Oracle and/or its affiliates. All rights
reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -30,13 +30,13 @@
* adapted. Functional interfaces can provide a target type in
multiple contexts,
* such as assignment context, method invocation, or cast context:
*
- * <pre>
- * Predicate<String> p = String::isEmpty;
+ * <pre>{@code
+ * Predicate<String> p = String::isEmpty;
*
* stream.filter(e -> e.getSize() > 10)...
*
* stream.map((ToIntFunction) e -> e.getSize())...
- * </pre>
+ * }</pre>
*
* <p>The interfaces in this package are functional interfaces used by
the JDK,
* and are available to be used by user code as well. While they do
not identify
More information about the core-libs-dev
mailing list