RFR: 8028041 Serialized Form description of j.l.String is not consistent with the implementation

[Stuart Marks]

On 11/8/13 1:34 PM, Alan Bateman wrote:
> On 08/11/2013 20:56, roger riggs wrote:
>> Please review this correction to the documentation of the serialized form of
>> String.
>> There is no change to the specification or behavior of the serialization of
>> strings.
>>
>> It seemed safer to refer to the serialization specification and remove the
>> incorrect details instead of trying to correct the incorrect details by adding
>> more detail.
>>
>> Webrev:
>>    http://cr.openjdk.java.net/~rriggs/webrev-string-serial-8028041/
> It make sense to reference the spec rather than duplicate how long strings are
> handled. So looks good to me (assuming the link works as expected when the docs
> are generated).

Hi Roger,

Yes, I agree with the approach of referencing the spec as well.

On the link format, I'd recommend using {@docRoot} instead of a long chain of 
double dots. (Yes, this is used inconsistent in the javadoc. It's yet another 
thing to be cleaned up.)

s'marks