Summary
-------

Clarify the method description of `java.nio.charset.CharsetEncoder#maxBytesPerChar()` method with regard to content-independent prefix/suffix output bytes.

Problem
-------

An implementation of `CharsetEncoder.maxBytesPerChar()`, which does not account for content-independent prefix/suffix bytes, could end up insufficient output buffer size calculation, which leads to `BufferOverflowException`.

Solution
--------

Modify the method description by explicitly mentioning the accountancy of content-independent prefix/suffix.

Specification
-------------

Change the paragraph in the method description of `java.nio.charset.Charset$Coder$` from:

     * Returns the maximum number of $otype$s that will be produced for each
     * $itype$ of input.  This value may be used to compute the worst-case size
     * of the output buffer required for a given input sequence.

to:

      * Returns the maximum number of $otype$s that will be produced for each
      * $itype$ of input.  This value may be used to compute the worst-case size
      * of the output buffer required for a given input sequence. This value
      * accounts for any necessary content-independent prefix or suffix
    #if[encoder]
      * $otype$s, such as byte-order marks.
    #end[encoder]
    #if[decoder]
      * $otype$s.
    #end[decoder]