[Checkins] SVN: PluggableAuthService/branches/seattle-sprint/interfaces/ Merge trunk and update interface descriptions

[Wichert Akkerman]

Log message for revision 71038:
  Merge trunk and update interface descriptions

Changed:
  U   PluggableAuthService/branches/seattle-sprint/interfaces/authservice.py
  U   PluggableAuthService/branches/seattle-sprint/interfaces/plugins.py
  U   PluggableAuthService/branches/seattle-sprint/interfaces/propertysheets.py

-=-
Modified: PluggableAuthService/branches/seattle-sprint/interfaces/authservice.py
===================================================================
--- PluggableAuthService/branches/seattle-sprint/interfaces/authservice.py	2006-11-02 21:04:39 UTC (rev 71037)
+++ PluggableAuthService/branches/seattle-sprint/interfaces/authservice.py	2006-11-02 22:14:26 UTC (rev 71038)
@@ -124,7 +124,7 @@
         """ Set properties on a user.
 
         This updates one or more properties on a user. Each property is
-        set on the first property sheet which has the property.
+        set on the first mutable property sheet which has the property.
         """
 
 

Modified: PluggableAuthService/branches/seattle-sprint/interfaces/plugins.py
===================================================================
--- PluggableAuthService/branches/seattle-sprint/interfaces/plugins.py	2006-11-02 21:04:39 UTC (rev 71037)
+++ PluggableAuthService/branches/seattle-sprint/interfaces/plugins.py	2006-11-02 22:14:26 UTC (rev 71038)
@@ -134,6 +134,9 @@
 class ICredentialsUpdatePlugin( Interface ):
 
     """ Callback:  user has changed her password.
+
+    This interface is not responsible for the actual password change,
+    it is used after a successful password change event.
     """
 
     def updateCredentials( request, response, login, new_password ):
@@ -216,6 +219,9 @@
 
         o May assign properties based on values in the REQUEST object, if
           present
+
+        o the return value can be either a dictionary or a IPropertySheet
+          providing object
         """
 
 class IGroupsPlugin( Interface ):

Modified: PluggableAuthService/branches/seattle-sprint/interfaces/propertysheets.py
===================================================================
--- PluggableAuthService/branches/seattle-sprint/interfaces/propertysheets.py	2006-11-02 21:04:39 UTC (rev 71037)
+++ PluggableAuthService/branches/seattle-sprint/interfaces/propertysheets.py	2006-11-02 22:14:26 UTC (rev 71038)
@@ -86,3 +86,6 @@
 
         """ Return a sequence of ( id, value ) tuples, one per property.
         """
+
+class IMutablePropertySheet ( IPropertySheet ):
+    def setProperties( id,