Update the IUser interface and tests, specifically as it relates to

preferences.  IAddresses, IUsers, and IMembers all get preferences by default,
althoughthe attributes of these preferences are None by default.

IMailingLists don't get preferences by default though; because these live in
the user database, we can't cross-polinate them in the mailing lists.  We'll
figure something out later for these.

IUser.register(): Add this method which registers and links an address to the
user.

Allow EnumType database columns to accept and return Nones.  This is useful
for when the columns are not defined NOT NULL.

Update doctests.

Removed teh hide_address preference.  I can't think of a reason not to want to
hide addresses for everyone.

1 files changed, 23 insertions, 15 deletions

diff --git a/Mailman/interfaces/profile.py b/Mailman/interfaces/profile.py
index a0b5131cb..17cfebae6 100644
--- a/Mailman/interfaces/profile.py
+++ b/Mailman/interfaces/profile.py
@@ -25,29 +25,37 @@ class IPreferences(Interface):
     """Delivery related information."""
 
     acknowledge_posts = Attribute(
-        """Boolean specifying whether to send an acknowledgment receipt for
-        every posting to the mailing list.
-        """)
+        """Send an acknowledgment for every posting?
 
-    hide_address = Attribute(
-        """Boolean specifying whether to hide this email address from fellow
-        list members.
-        """)
+        This preference can be True, False, or None.  True means the user is
+        sent a receipt for each message they send to the mailing list.  False
+        means that no receipt is sent.  None means no preference is
+        specified.""")
 
     preferred_language = Attribute(
-        """Preferred language for interacting with a mailing list.""")
+        """The preferred language for interacting with a mailing list.
+
+        This is either the language code for the preferred language, or None
+        meaning no preferred language is specified.""")
 
     receive_list_copy = Attribute(
-        """Boolean specifying whether to receive a list copy if the user is
-        explicitly named in one of the recipient headers.
-        """)
+        """Should an explicit recipient receive a list copy?
+
+        When a list member is explicitly named in a message's recipients
+        (e.g. the To or CC headers), and this preference is True, the
+        recipient will still receive a list copy of the message.  When False,
+        this list copy will be suppressed.  None means no preference is
+        specified.""")
 
     receive_own_postings = Attribute(
-        """Boolean specifying whether to receive a list copy of the user's own
-        postings to the mailing list.
-        """)
+        """Should the poster get a list copy of their own messages?
+
+        When this preference is True, a list copy will be sent to the poster
+        of all messages.  When False, this list copy will be suppressed.  None
+        means no preference is specified.""")
 
     delivery_mode = Attribute(
         """The preferred delivery mode.
 
-        This is an enum constant of the type DeliveryMode.""")
+        This is an enum constant of the type DeliveryMode.  It may also be
+        None which means that no preference is specified.""")