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 - * DataFlavors 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 DataFlavors 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)