Recently added documentation in String.java includes references like:

     * @param charsetName the name of a supported
     * {@link java.nio.charset.Charset </code>charset<code>}

This is ugly and dependent on implementation details of {@link...}.
We should instead be using the architected solution to achieve the same effect,
simply

{@linkplain Charset charset}

There are also a number of @link's that should simply be changed to @linkplain,
e.g.

     * bytes using the specified {@link java.nio.charset.Charset charset}. The