← Back to branch summary

~barry/mailman/events-and-web

« back to all changes in this revision

Viewing changes to src/mailman/app/docs/subscriptions.rst

  • Committer: Barry Warsaw
  • Date: 2011-08-18 00:39:11 UTC
  • mfrom: (7036.1.4 bug-827036)
  • Revision ID: barry@list.org-20110818003911-9gef1p84g2pg4p10
 * Four new events are created, and notifications are sent during mailing list
   lifecycle changes:
   - ListCreatingEvent - sent before the mailing list is created
   - ListCreatedEvent  - sent after the mailing list is created
   - ListDeletingEvent - sent before the mailing list is deleted
   - ListDeletedEvent  - sent after the mailing list is deleted
 * Using the above events, when a mailing list is deleted, all its members are
   deleted, as well as all held message requests (but not the held messages
   themselves).  (LP: 827036)

Also: relax the find_member() argument constraints so that even the subscriber
email address is optional.  This is mirrored in the REST API's
.../members/find resource.

Show diffs side-by-side

added added

removed removed

Lines of Context:
src/mailman/app/docs/subscriptions.rst
79
79
    <Member: anne <anne@example.com> on test@example.com as MemberRole.owner>
80
80
 
81
81
If you know the member's address, you can find all their memberships, based on
82
 
specific search criteria.  At a minimum, you need the member's email address.
 
82
specific search criteria.
83
83
::
84
84
 
85
85
    >>> mlist2 = create_list('foo@example.com')
121
121
     <Member: anne <anne@example.com> on test@example.com
122
122
              as MemberRole.moderator>]
123
123
 
 
124
You can find all the memberships for a specific mailing list.
 
125
 
 
126
    >>> service.find_members(fqdn_listname='test@example.com')
 
127
    [<Member: anne <anne@example.com> on test@example.com
 
128
              as MemberRole.member>,
 
129
     <Member: anne <anne@example.com> on test@example.com as MemberRole.owner>,
 
130
     <Member: anne <anne@example.com> on test@example.com
 
131
              as MemberRole.moderator>,
 
132
     <Member: Bart Person <bart@example.com> on test@example.com
 
133
              as MemberRole.member>]
 
134
 
124
135
You can find all the memberships for an address on a specific mailing list.
125
136
 
126
137
    >>> service.find_members('anne@example.com', 'test@example.com')