diff -r 5ff2edfa03fc -r 02c95aa8a53a jdk/src/java.datatransfer/share/classes/java/awt/datatransfer/StringSelection.java
--- a/jdk/src/java.datatransfer/share/classes/java/awt/datatransfer/StringSelection.java Sat Jun 17 11:50:55 2017 -0700
+++ b/jdk/src/java.datatransfer/share/classes/java/awt/datatransfer/StringSelection.java Sun Jun 18 17:33:47 2017 +0300
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1996, 2014, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1996, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -25,23 +25,21 @@
package java.awt.datatransfer;
-import java.io.*;
-
+import java.io.IOException;
+import java.io.StringReader;
/**
- * A Transferable
which implements the capability required
- * to transfer a String
.
+ * A {@code Transferable} which implements the capability required to transfer a
+ * {@code String}.
+ *
+ * This {@code Transferable} properly supports {@code DataFlavor.stringFlavor}
+ * and all equivalent flavors. Support for {@code DataFlavor.plainTextFlavor}
+ * and all equivalent flavors is deprecated. No other {@code DataFlavor}s
+ * are supported.
*
- * This Transferable
properly supports
- * DataFlavor.stringFlavor
- * and all equivalent flavors. Support for
- * DataFlavor.plainTextFlavor
- * and all equivalent flavors is deprecated. No other
- * DataFlavor
s are supported.
- *
+ * @see DataFlavor#stringFlavor
+ * @see DataFlavor#plainTextFlavor
* @since 1.1
- * @see java.awt.datatransfer.DataFlavor#stringFlavor
- * @see java.awt.datatransfer.DataFlavor#plainTextFlavor
*/
public class StringSelection implements Transferable, ClipboardOwner {
@@ -57,23 +55,23 @@
private String data;
/**
- * Creates a Transferable
capable of transferring
- * the specified String
.
- * @param data the string to be transferred
+ * Creates a {@code Transferable} capable of transferring the specified
+ * {@code String}.
+ *
+ * @param data the string to be transferred
*/
public StringSelection(String data) {
this.data = data;
}
/**
- * Returns an array of flavors in which this Transferable
- * can provide the data. DataFlavor.stringFlavor
- * is properly supported.
- * Support for DataFlavor.plainTextFlavor
is
- * deprecated.
+ * Returns an array of flavors in which this {@code Transferable} can
+ * provide the data. {@code DataFlavor.stringFlavor} is properly supported.
+ * Support for {@code DataFlavor.plainTextFlavor} is deprecated.
*
- * @return an array of length two, whose elements are DataFlavor.
- * stringFlavor
and DataFlavor.plainTextFlavor
+ * @return an array of length two, whose elements are
+ * {@code DataFlavor.stringFlavor} and
+ * {@code DataFlavor.plainTextFlavor}
*/
public DataFlavor[] getTransferDataFlavors() {
// returning flavors itself would allow client code to modify
@@ -83,14 +81,14 @@
/**
* Returns whether the requested flavor is supported by this
- * Transferable
.
+ * {@code Transferable}.
*
- * @param flavor the requested flavor for the data
- * @return true if flavor
is equal to
- * DataFlavor.stringFlavor
or
- * DataFlavor.plainTextFlavor
; false if flavor
- * is not one of the above flavors
- * @throws NullPointerException if flavor is null
+ * @param flavor the requested flavor for the data
+ * @return {@code true} if {@code flavor} is equal to
+ * {@code DataFlavor.stringFlavor} or
+ * {@code DataFlavor.plainTextFlavor}; {@code false} if
+ * {@code flavor} is not one of the above flavors
+ * @throws NullPointerException if {@code flavor} is {@code null}
*/
public boolean isDataFlavorSupported(DataFlavor flavor) {
// JCK Test StringSelection0003: if 'flavor' is null, throw NPE
@@ -103,27 +101,27 @@
}
/**
- * Returns the Transferable
's data in the requested
- * DataFlavor
if possible. If the desired flavor is
- * DataFlavor.stringFlavor
, or an equivalent flavor,
- * the String
representing the selection is
- * returned. If the desired flavor is
- * DataFlavor.plainTextFlavor
,
- * or an equivalent flavor, a Reader
is returned.
+ * Returns the {@code Transferable}'s data in the requested
+ * {@code DataFlavor} if possible. If the desired flavor is
+ * {@code DataFlavor.stringFlavor}, or an equivalent flavor, the
+ * {@code String} representing the selection is returned. If the desired
+ * flavor is {@code DataFlavor.plainTextFlavor}, or an equivalent flavor, a
+ * {@code Reader} is returned.
+ *
* Note: The behavior of this method for
- * DataFlavor.plainTextFlavor
- * and equivalent DataFlavor
s is inconsistent with the
- * definition of DataFlavor.plainTextFlavor
.
+ * {@code DataFlavor.plainTextFlavor}
+ * and equivalent {@code DataFlavor}s is inconsistent with the definition of
+ * {@code DataFlavor.plainTextFlavor}.
*
- * @param flavor the requested flavor for the data
+ * @param flavor the requested flavor for the data
* @return the data in the requested flavor, as outlined above
- * @throws UnsupportedFlavorException if the requested data flavor is
- * not equivalent to either DataFlavor.stringFlavor
- * or DataFlavor.plainTextFlavor
+ * @throws UnsupportedFlavorException if the requested data flavor is not
+ * equivalent to either {@code DataFlavor.stringFlavor} or
+ * {@code DataFlavor.plainTextFlavor}
* @throws IOException if an IOException occurs while retrieving the data.
* By default, StringSelection never throws this exception, but a
* subclass may.
- * @throws NullPointerException if flavor is null
+ * @throws NullPointerException if {@code flavor} is {@code null}
* @see java.io.Reader
*/
public Object getTransferData(DataFlavor flavor)