--- old/src/share/classes/java/security/Permissions.java 2013-06-27 23:05:27.613546213 -0700 +++ new/src/share/classes/java/security/Permissions.java 2013-06-27 23:05:27.453546216 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 1997, 2011, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997, 2013, 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 @@ -44,26 +44,26 @@ * This class represents a heterogeneous collection of Permissions. That is, * it contains different types of Permission objects, organized into * PermissionCollections. For example, if any - * java.io.FilePermission objects are added to an instance of + * {@code java.io.FilePermission} objects are added to an instance of * this class, they are all stored in a single * PermissionCollection. It is the PermissionCollection returned by a call to - * the newPermissionCollection method in the FilePermission class. - * Similarly, any java.lang.RuntimePermission objects are + * the {@code newPermissionCollection} method in the FilePermission class. + * Similarly, any {@code java.lang.RuntimePermission} objects are * stored in the PermissionCollection returned by a call to the - * newPermissionCollection method in the + * {@code newPermissionCollection} method in the * RuntimePermission class. Thus, this class represents a collection of * PermissionCollections. * - *

When the add method is called to add a Permission, the + *

When the {@code add} method is called to add a Permission, the * Permission is stored in the appropriate PermissionCollection. If no such * collection exists yet, the Permission object's class is determined and the - * newPermissionCollection method is called on that class to create + * {@code newPermissionCollection} method is called on that class to create * the PermissionCollection and add it to the Permissions object. If - * newPermissionCollection returns null, then a default + * {@code newPermissionCollection} returns null, then a default * PermissionCollection that uses a hashtable will be created and used. Each * hashtable entry stores a Permission object as both the key and the value. * - *

Enumerations returned via the elements method are + *

Enumerations returned via the {@code elements} method are * not fail-fast. Modifications to a collection should not be * performed while enumerating over that collection. * @@ -155,9 +155,9 @@ * "read" access for all files in all subdirectories of the "/tmp" * directory, and another FilePermission that specifies "write" access * for all files in the "/tmp/scratch/foo" directory. - * Then if the implies method + * Then if the {@code implies} method * is called with a permission specifying both "read" and "write" access - * to files in the "/tmp/scratch/foo" directory, true is + * to files in the "/tmp/scratch/foo" directory, {@code true} is * returned. * *

Additionally, if this PermissionCollection contains the @@ -214,11 +214,11 @@ * If createEmpty is true, * this method creates a new PermissionCollection object for the specified * type of permission objects if one does not yet exist. - * To do so, it first calls the newPermissionCollection method + * To do so, it first calls the {@code newPermissionCollection} method * on p. Subclasses of class Permission * override that method if they need to store their permissions in a * particular PermissionCollection object in order to provide the - * correct semantics when the PermissionCollection.implies + * correct semantics when the {@code PermissionCollection.implies} * method is called. * If the call returns a PermissionCollection, that collection is stored * in this Permissions object. If the call returns null and createEmpty