GNU Mailman 3.0.0 "Show Don't Tell"

3.0.0 -- "Show Don't Tell"
==========================
(2015-04-28)

Architecture
------------
 * Domains now have a list of owners, which are ``IUser`` objects, instead of
   the single ``contact_address`` they used to have. ``IUser`` objects now
   also have a ``is_server_owner`` flag (defaulting to False) to indicate
   whether they have superuser privileges. Give by Abhliash Raj, with fixes
   and refinements by Barry Warsaw. (LP: #1423756)
 * Mailing list subscription policy work flow has been completely rewritten.
   It now properly supports email verification and subscription confirmation
   by the user, and approval by the moderator using unique tokens.
   ``IMailingList`` objects now have a ``subscription_policy`` attribute.
   (LP: #1095552)
 * Port the REST machinery to Falcon 0.3. (LP: #1446881)

Bugs
----
 * Fix calculation of default configuration file to use when the ``$var_dir``
   is created by ``mailman start``. (LP: #1411435)
 * When creating a user with an email address, do not create the user record
   if the email address already exists. Given by Andrew Stuart.
   (LP: #1418280)
 * When deleting a user via REST, make sure all linked addresses are deleted.
   Found by Andrew Stuart. (LP: #1419519)
 * When trying to subscribe an address to a mailing list through the REST API
   where a case-differing version of the address is already subscribed, return
   a 409 error instead of a 500 error. Found by Ankush Sharma. (LP: #1425359)
 * ``mailman lists --domain`` was not properly handling its arguments. Given
   by Manish Gill. (LP: #1166911)
 * When deleting a user object, make sure their preferences are also deleted.
   Given by Abhishek. (LP: #1418276)
 * Be sure a mailing list's acceptable aliases are deleted when the mailing
   list itself is deleted. (LP: #1432239)
 * The built-in example ``IArchiver`` implementations now explicitly return
   None. (LP: #1203359)
 * The test suite now runs successfully again with PostgreSQL. Given by
   Aurélien Bompard. (LP: #1435941)

Configuration
-------------
 * When specifying a file system path in the [paths.*] section, $cfg_file can
   be used to expand into the path of the ``-C`` option if given. In the
   default ``[paths.dev]`` section, ``$var_dir`` is now specified relative to
   ``$cfg_file`` so that it won't accidentally be relative to the current
   working directory, if ``-C`` is given.
 * ``$cwd`` is now an additional substitution variable for the ``mailman.cfg``
   file's ``[paths.*]`` sections. A new ``[paths.here]`` section is added,
   which puts the ``var_dir`` in ``$cwd``. It is made the default layout.

Documentation
-------------
 * Improve the documentation describing how to run Alembic to add new schema
   migrations. Given by Abhilash Raj.

REST
----
 * **Backward incompatible change**: The JSON representation for pending
   mailing list subscription hold now no longer includes the ``password``
   key. Also, the ``address`` key has been renamed ``email`` for consistent
   terminology and other usage.
 * You can now view the contents of, inject messages into, and delete messages
   from the various queue directories via the ``<api>/queues`` resource.
 * You can now DELETE an address. If the address is linked to a user, the
   user is not delete, it is just unlinked.
 * A new API is provided to support non-production testing infrastructures,
   allowing a client to cull all orphaned UIDs via ``DELETE`` on
   ``<api>/reserved/uids/orphans``. Note that *no guarantees* of API
   stability will ever be made for resources under ``reserved``.
   (LP: #1420083)
 * Domains can now optionally be created with owners; domain owners can be
   added after the fact; domain owners can be deleted. Also, users now have
   an ``is_server_owner`` flag as part of their representation, which defaults
   to False, and can be PUT and PATCH'd. Given by Abhilash Raj, with fixes
   and refinements by Barry Warsaw. (LP: #1423756)