diff -r 26b816b3f236 -r 3c7eda3ab2f5 jdk/src/share/classes/java/lang/Long.java --- a/jdk/src/share/classes/java/lang/Long.java Mon Aug 15 00:30:35 2011 -0700 +++ b/jdk/src/share/classes/java/lang/Long.java Mon Aug 15 12:56:01 2011 -0700 @@ -806,22 +806,20 @@ * Determines the {@code long} value of the system property * with the specified name. * - *

The first argument is treated as the name of a system property. - * System properties are accessible through the {@link + *

The first argument is treated as the name of a system + * property. System properties are accessible through the {@link * java.lang.System#getProperty(java.lang.String)} method. The - * string value of this property is then interpreted as a - * {@code long} value and a {@code Long} object - * representing this value is returned. Details of possible - * numeric formats can be found with the definition of - * {@code getProperty}. + * string value of this property is then interpreted as a {@code + * long} value using the grammar supported by {@link Long#decode decode} + * and a {@code Long} object representing this value is returned. * *

If there is no property with the specified name, if the - * specified name is empty or {@code null}, or if the - * property does not have the correct numeric format, then - * {@code null} is returned. + * specified name is empty or {@code null}, or if the property + * does not have the correct numeric format, then {@code null} is + * returned. * - *

In other words, this method returns a {@code Long} object equal to - * the value of: + *

In other words, this method returns a {@code Long} object + * equal to the value of: * *

* {@code getLong(nm, null)} @@ -840,14 +838,12 @@ * Determines the {@code long} value of the system property * with the specified name. * - *

The first argument is treated as the name of a system property. - * System properties are accessible through the {@link + *

The first argument is treated as the name of a system + * property. System properties are accessible through the {@link * java.lang.System#getProperty(java.lang.String)} method. The - * string value of this property is then interpreted as a - * {@code long} value and a {@code Long} object - * representing this value is returned. Details of possible - * numeric formats can be found with the definition of - * {@code getProperty}. + * string value of this property is then interpreted as a {@code + * long} value using the grammar supported by {@link Long#decode decode} + * and a {@code Long} object representing this value is returned. * *

The second argument is the default value. A {@code Long} object * that represents the value of the second argument is returned if there @@ -889,8 +885,8 @@ * the {@link java.lang.System#getProperty(java.lang.String)} * method. The string value of this property is then interpreted * as a {@code long} value, as per the - * {@code Long.decode} method, and a {@code Long} object - * representing this value is returned. + * {@link Long#decode decode} method, and a {@code Long} object + * representing this value is returned; in summary: * *