JDK-7082231 : Put a @since 1.7 on System.lineSeparator
  • Type: Enhancement
  • Component: core-libs
  • Sub-Component: java.io
  • Affected Version: 7
  • Priority: P4
  • Status: Closed
  • Resolution: Fixed
  • OS: windows_xp,windows_7
  • CPU: x86
  • Submitted: 2011-08-23
  • Updated: 2013-04-09
  • Resolved: 2012-05-14
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 8
8 b04Fixed
Related Reports
Duplicate :  
JDK-7094275 - javadoc java.lang.System#lineSeparator() missing @since 1.7 annotation
Duplicate :  
JDK-8011796 - Missing " Since: 1.7 " marking for java.lang.System#lineSeparator
Relates :  
JDK-6900043 - Add method to return line.separator property
Relates :  
JDK-7088500 - there is no @since tag on SafeVarargs
Description
A DESCRIPTION OF THE PROBLEM :
Put a @since 1.7 on System.lineSeparator

(This is platform independent, but this wonderful bug tool force me to choose an OS)

EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
/**
     * Returns the system-dependent line separator string.  It always
     * returns the same value - the initial value of the {@linkplain
     * #getProperty(String) system property} {@code line.separator}.
     *
     * <p>On UNIX systems, it returns {@code "\n"}; on Microsoft
     * Windows systems it returns {@code "\r\n"}.
    * @since 1.7
     */
ACTUAL -
/**
     * Returns the system-dependent line separator string.  It always
     * returns the same value - the initial value of the {@linkplain
     * #getProperty(String) system property} {@code line.separator}.
     *
     * <p>On UNIX systems, it returns {@code "\n"}; on Microsoft
     * Windows systems it returns {@code "\r\n"}.
     */

URL OF FAULTY DOCUMENTATION :
http://hg.openjdk.java.net/jdk7/jdk7/jdk/rev/0dcdb13ab6d0
Comments
SUGGESTED FIX # HG changeset patch # User darcy # Date 1314142505 25200 # Node ID 440161cc9af85e7aca796ef46d5c76ab4f5edd40 # Parent 4e53fc6bcac0f9d289f4f3a61d652a951fefa93d 7082231: Put a @since 1.7 on System.lineSeparator Reviewed-by: mduigou --- a/src/share/classes/java/lang/System.java Tue Aug 23 10:35:50 2011 -0700 +++ b/src/share/classes/java/lang/System.java Tue Aug 23 16:35:05 2011 -0700 @@ -632,6 +632,7 @@ public final class System { * * <p>On UNIX systems, it returns {@code "\n"}; on Microsoft * Windows systems it returns {@code "\r\n"}. + * @since 1.7 */ public static String lineSeparator() { return lineSeparator;
23-08-2011
PUBLIC COMMENTS See http://hg.openjdk.java.net/jdk8/tl/jdk/rev/440161cc9af8
23-08-2011
EVALUATION The fix for 6900043 omitted an @since tag; oops! This should be corrected.
23-08-2011