1 files changed, 9 insertions, 0 deletions

diff --git a/Mailman/interfaces/user.py b/Mailman/interfaces/user.py
index bed1db08d..9e89c2416 100644
--- a/Mailman/interfaces/user.py
+++ b/Mailman/interfaces/user.py
@@ -36,6 +36,15 @@ class IUser(Interface):
     addresses = Attribute(
         """An iterator over all the IAddresses controlled by this user.""")
 
+    def register(address):
+        """Register the given email address and link it to this user.
+
+        In this case, 'address' is a text email address, not an IAddress
+        object.  Raises AddressAlreadyLinkedError if this IAddress is already
+        linked to another user.  If the corresponding IAddress already exists
+        but is not linked, then it is simply linked to the user.
+        """
+
     def link(address):
         """Link this user to the given IAddress.