JDK 8 request for review: doclint fixes for some package-info files

[David Holmes]

Ship it! :)

David

On 19/07/2013 4:38 PM, Joe Darcy wrote:
> 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>   &nbsp<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
>