JDK-8245399 : Remove addition preview adornment from String::formatted
  • Type: CSR
  • Component: core-libs
  • Sub-Component: java.lang
  • Priority: P3
  • Status: Closed
  • Resolution: Approved
  • Fix Versions: 15
  • Submitted: 2020-05-19
  • Updated: 2020-05-20
  • Resolved: 2020-05-20
Related Reports
CSR :  
Description
Summary
-------

The JavaDoc for String::formatted still contains JavaDoc elements that should be updated before release.

Problem
-------

The current state of the JavaDoc indicates a preview status.

Solution
--------

Correct the JavaDoc.

Specification
-------------

```
diff -r 0fb0ddc73771 src/java.base/share/classes/java/lang/String.java 
--- a/src/java.base/share/classes/java/lang/String.java Tue May 19 15:57:59 2020 -0300 
+++ b/src/java.base/share/classes/java/lang/String.java Tue May 19 16:46:08 2020 -0300 
@@ -3322,15 +3322,6 @@ 
     } 
  
     /** 
- * {@preview Associated with text blocks, a preview feature of 
- * the Java language. 
- * 
- * This method is associated with <i>text blocks</i>, a preview 
- * feature of the Java language. Programs can only use this 
- * method when preview features are enabled. Preview features 
- * may be removed in a future release, or upgraded to permanent 
- * features of the Java language.} 
- * 
      * Formats using this string as the format string, and the supplied 
      * arguments. 
      * 
@@ -3344,7 +3335,7 @@ 
      * @see java.lang.String#format(String,Object...) 
      * @see java.util.Formatter 
      * 
- * @since 13 
+ * @since 15 
      * 
      */ 
     public String formatted(Object... args) { 
```
Comments
Moving to Approved.
20-05-2020

Review: https://mail.openjdk.java.net/pipermail/core-libs-dev/2020-May/066553.html
20-05-2020