src/java.base/share/classes/java/lang/String.java
branchJDK-8226585-branch
changeset 58440 4c8a6d1d066c
parent 58109 ee07de0d2c16
--- a/src/java.base/share/classes/java/lang/String.java	Wed Sep 25 21:19:21 2019 +0200
+++ b/src/java.base/share/classes/java/lang/String.java	Wed Oct 02 10:59:40 2019 +0200
@@ -2888,6 +2888,14 @@
     }
 
     /**
+     * {@preview {@previewSummary 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.}
+     *
      * Returns a string whose value is this string, with incidental
      * {@linkplain Character#isWhitespace(int) white space} removed from
      * the beginning and end of every line.
@@ -2963,8 +2971,6 @@
      *
      * @since 13
      *
-     * @preview This method is associated with text blocks, a preview language feature.
-     *          Text blocks and/or this method may be changed or removed in a future release.
      */
     @jdk.internal.PreviewFeature(feature=jdk.internal.PreviewFeature.Feature.TEXT_BLOCKS,
                                  essentialAPI=true)
@@ -3006,6 +3012,14 @@
     }
 
     /**
+     * {@preview {@previewSummary 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.}
+     *
      * Returns a string whose value is this string, with escape sequences
      * translated as if in a string literal.
      * <p>
@@ -3080,9 +3094,6 @@
      * @jls 3.10.7 Escape Sequences
      *
      * @since 13
-     *
-     * @preview  This method is associated with text blocks, a preview language feature.
-     *           Text blocks and/or this method may be changed or removed in a future release.
      */
     @jdk.internal.PreviewFeature(feature=jdk.internal.PreviewFeature.Feature.TEXT_BLOCKS,
                                  essentialAPI=true)
@@ -3311,6 +3322,15 @@
     }
 
     /**
+     * {@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.
      *
@@ -3326,8 +3346,6 @@
      *
      * @since 13
      *
-     * @preview  This method is associated with text blocks, a preview language feature.
-     *           Text blocks and/or this method may be changed or removed in a future release.
      */
     @jdk.internal.PreviewFeature(feature=jdk.internal.PreviewFeature.Feature.TEXT_BLOCKS,
                                  essentialAPI=true)