--- old/src/java.datatransfer/share/classes/java/awt/datatransfer/FlavorMap.java 2017-05-23 19:14:14.000000000 -0700
+++ new/src/java.datatransfer/share/classes/java/awt/datatransfer/FlavorMap.java 2017-05-23 19:14:14.000000000 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 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
@@ -27,49 +27,45 @@
import java.util.Map;
-
/**
- * A two-way Map between "natives" (Strings), which correspond to platform-
- * specific data formats, and "flavors" (DataFlavors), which correspond to
- * platform-independent MIME types. FlavorMaps need not be symmetric, but
+ * A two-way Map between "natives" (Strings), which correspond to
+ * platform-specific data formats, and "flavors" (DataFlavors), which correspond
+ * to platform-independent MIME types. FlavorMaps need not be symmetric, but
* typically are.
*
- *
* @since 1.2
*/
public interface FlavorMap {
/**
- * Returns a Map
of the specified DataFlavor
s to
- * their corresponding String
native. The returned
- * Map
is a modifiable copy of this FlavorMap
's
- * internal data. Client code is free to modify the Map
- * without affecting this object.
+ * Returns a {@code Map} of the specified {@code DataFlavor}s to their
+ * corresponding {@code String} native. The returned {@code Map} is a
+ * modifiable copy of this {@code FlavorMap}'s internal data. Client code is
+ * free to modify the {@code Map} without affecting this object.
*
- * @param flavors an array of DataFlavor
s which will be the
- * key set of the returned Map
. If null
is
- * specified, a mapping of all DataFlavor
s currently
- * known to this FlavorMap
to their corresponding
- * String
natives will be returned.
- * @return a java.util.Map
of DataFlavor
s to
- * String
natives
+ * @param flavors an array of {@code DataFlavor}s which will be the key set
+ * of the returned {@code Map}. If {@code null} is specified, a
+ * mapping of all {@code DataFlavor}s currently known to this
+ * {@code FlavorMap} to their corresponding {@code String} natives
+ * will be returned.
+ * @return a {@code java.util.Map} of {@code DataFlavor}s to {@code String}
+ * natives
*/
- Map getNativesForFlavors(DataFlavor[] flavors);
+ Map getNativesForFlavors(DataFlavor[] flavors);
/**
- * Returns a Map
of the specified String
natives
- * to their corresponding DataFlavor
. The returned
- * Map
is a modifiable copy of this FlavorMap
's
- * internal data. Client code is free to modify the Map
- * without affecting this object.
+ * Returns a {@code Map} of the specified {@code String} natives to their
+ * corresponding {@code DataFlavor}. The returned {@code Map} is a
+ * modifiable copy of this {@code FlavorMap}'s internal data. Client code is
+ * free to modify the {@code Map} without affecting this object.
*
- * @param natives an array of String
s which will be the
- * key set of the returned Map
. If null
is
- * specified, a mapping of all String
natives currently
- * known to this FlavorMap
to their corresponding
- * DataFlavor
s will be returned.
- * @return a java.util.Map
of String
natives to
- * DataFlavor
s
+ * @param natives an array of {@code String}s which will be the key set of
+ * the returned {@code Map}. If {@code null} is specified, a mapping
+ * of all {@code String} natives currently known to this
+ * {@code FlavorMap} to their corresponding {@code DataFlavor}s will
+ * be returned.
+ * @return a {@code java.util.Map} of {@code String} natives to
+ * {@code DataFlavor}s
*/
- Map getFlavorsForNatives(String[] natives);
+ Map getFlavorsForNatives(String[] natives);
}