[Zope-Checkins] CVS: Zope3/lib/python/Zope/App/Security - IPrincipalPermissionManager.py:1.1.2.2 IPrincipalPermissionMap.py:1.1.2.2

[Casey Duncan]

Update of /cvs-repository/Zope3/lib/python/Zope/App/Security
In directory cvs.zope.org:/tmp/cvs-serv13637

Modified Files:
      Tag: Zope-3x-branch
	IPrincipalPermissionManager.py IPrincipalPermissionMap.py 
Log Message:
Updated Interfaces and doc strings for PrinciplePermissionManager and
PrinciplePermissionMap


=== Zope3/lib/python/Zope/App/Security/IPrincipalPermissionManager.py 1.1.2.1 => 1.1.2.2 ===
 
     def grantPermissionToPrincipal(permission, principal):
-        """Bind the permission to the principal.
+        """Assert that the permission is allowed for the principal.
 
         permission must be an IPermission
         principal must be an IPrincipal
         """
+
+    def denyPermissionToPrincipal(permission, principal):
+        """Assert that the permission is denied to the principal.
+
+        permission must be an IPermission
+        principal must be an IPrincipal
+        """
+
+    def unsetPermissionForPrincipal(permission, principal):
+        """Remove the permission (either denied or allowed) from the
+        principal.
+
+        permission must be an IPermission
+        principal must be an IPrincipal
+        """
+        


=== Zope3/lib/python/Zope/App/Security/IPrincipalPermissionMap.py 1.1.2.1 => 1.1.2.2 ===
 
     def getPrincipalsForPermission(permission):
-        """Return the list of principals who have been granted permission.
+        """Return the list of (principal, setting) tuples that describe
+        security assertions for this permission.
 
         permission must be an IPermission.  If no principals have been
-        granted this permission, then the empty list is returned.
+        set for this permission, then the empty list is returned.
         """
 
     def getPermissionsForPrincipal(principal):
-        """Return the list of permission granted to this principal.
+        """Return the list of (permission, setting) tuples that describe
+        security assertions for this principal.
 
-        principal must be an IPrincipal.  If no permissions have been granted
-        to this principal, then the empty list is returned.
-        """
+        principal must be an IPrincipal.  If no permissions have been set for
+        this principal, then the empty list is returned.  """