RFR 9: 8165641 : Deprecate Object.finalize
Mandy Chung
mandy.chung at oracle.com
Wed Mar 15 02:19:59 UTC 2017
> On Mar 14, 2017, at 7:06 PM, Roger Riggs <roger.riggs at oracle.com> wrote:
>
> On 3/14/17 4:53 PM, Mandy Chung wrote:
>> This patch looks fine in general.
>>
>> Does @inheritDoc inherit @deprecated? What does the javadoc of javax.imageio.stream.* look like?
> Yes, the deprecation is inherited, see:
>
> http://cr.openjdk.java.net/~rriggs/finalize-doc/api/javax/imageio/stream/FileImageInputStream.html
>
If so, @deprecated is not needed in the method that does have {@inheritDoc} e.g. line 158-159, is it?
156 /**
157 * {@inheritDoc}
158 * @deprecated Finalization is deprecated and should not be used. See
159 * {@link Object#finalize} for the explanation and recommended replacement.
160 */
>>
>> + * @deprecated Finalization is deprecated and should not be used.
>> + * See {@link Object#finalize} for the explanation and recommended replacement.
>>
>> Also, the second line is rather long and might be good to break into two lines?
> The style guide allows a somewhat longer line. I moved the "See" to the previous line.
> it didn't seem worth adding more vertical space for a couple of words.
Maybe trim the spaces before {@link Object#finalize}.
Mandy
More information about the core-libs-dev
mailing list