--- 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 DataFlavors 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 DataFlavors which will be the - * key set of the returned Map. If null is - * specified, a mapping of all DataFlavors currently - * known to this FlavorMap to their corresponding - * String natives will be returned. - * @return a java.util.Map of DataFlavors 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 Strings 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 - * DataFlavors will be returned. - * @return a java.util.Map of String natives to - * DataFlavors + * @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); }