JDK 9 RFR of JDK-8066617: Suppress deprecation warnings in java.base module

[joe darcy]

Hello,

First some background, one of the JEPs targeted to JDK 9 is

     JEP 212: Resolve Lint and Doclint Warnings
     http://openjdk.java.net/jeps/212

In the jdk repository, only the deprecation category of lint warnings 
remain. While resolving the other categories of warnings mostly involved 
area-agnostic Java language expertise (say, to generify an API), fixing 
a deprecation warning by modifying code often involves very detailed 
area-specific knowledge. For that reason, to resolve the deprecation 
category of lint warnings, rather than updating the code per se, I'm 
only planning to @SuppressWarnings the issues. To track that work, I've 
filed the umbrella bug

     JDK-8066616: Suppress deprecation warnings in jdk libraries
     https://bugs.openjdk.java.net/browse/JDK-8066616

with subtasks for different modules in the build. I've also filed a 
sibling umbrella bug

     JDK-8066618: Fix deprecation warnings in jdk libraries
     https://bugs.openjdk.java.net/browse/JDK-8066618

which has a matching set of subtasks to have each deprecation location 
in the code be reexamined by someone familiar with the area.

With that background, first up is this review request for

     JDK-8066617: Suppress deprecation warnings in java.base module
     http://cr.openjdk.java.net/~darcy/8066617.0/

Thanks,

-Joe