RFR (XS) 8148730: Add @since tags in new String concat APIs

[Andrej Golovnin]

Hi Aleksej,

> I don't know, you tell me -- you have the tools that enforce
> @since-ness! Certainly, we can put @since on classes only, if that is
> acceptable.

I don't have such tools. But when I write JavaDocs I try to follow the
recommendations from this article:

http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html

And here is the excerpt from the article regarding the @since tag:

When a class (or interface) is introduced, specify one @since tag in
its class description and no @since tags in the members. Add an @since
tag only to members added in a later version than the class. This
minimizes the number of @since tags.

Best regards,
Andrej Golovnin