RFR: JDK-8185464: Link issues in java.xml module

[Lance Andersen]

Hi Jon,

Overall it looks good.  Maybe it is my browser, but I do not see the Author tag in the DataType package summary though it is there in JDK 8 and looks like it should still display unless I am missing something…

Best
Lance
> On Jul 27, 2017, at 4:35 PM, Jonathan Gibbons <jonathan.gibbons at oracle.com> wrote:
> 
> Continuing the documentation cleanup:
> 
> Please review the following simple changes to the API documentation for the java.xml module,
> to address issues with links in these files.
> 
> Some missing ids have been declared as appropriate.
> 
> The issue with a mailto: link in the public API to an obsolete address has been side-stepped
> by converting a number of explicit Author and See constructs to the equivalent @author and @see
> tags. Since we don't publish authors in the generated documentation, that addresses the
> appearance of the bad mailto: link.  I'll leave it to someone else to take on the general task of
> cleaning up the many references to obsolete @sun.com email addresses in the source code.
> 
> JBS: https://bugs.openjdk.java.net/browse/JDK-8185464
> Webrev: http://cr.openjdk.java.net/~jjg/8185464/webrev.00/
> API: http://cr.openjdk.java.net/~jjg/8185464/api.00/overview-summary.html
> 
> -- Jon
> 
> 

 <http://oracle.com/us/design/oracle-email-sig-198324.gif>
 <http://oracle.com/us/design/oracle-email-sig-198324.gif> <http://oracle.com/us/design/oracle-email-sig-198324.gif>
 <http://oracle.com/us/design/oracle-email-sig-198324.gif>Lance Andersen| Principal Member of Technical Staff | +1.781.442.2037
Oracle Java Engineering 
1 Network Drive 
Burlington, MA 01803
Lance.Andersen at oracle.com <mailto:Lance.Andersen at oracle.com>