3 files changed, 19 insertions, 0 deletions

diff --git a/src/mailman/interfaces/mailinglist.py b/src/mailman/interfaces/mailinglist.py
index 98f538dbe..6f88ef64c 100644
--- a/src/mailman/interfaces/mailinglist.py
+++ b/src/mailman/interfaces/mailinglist.py
@@ -340,6 +340,17 @@ class IMailingList(Interface):
         that gets created to accumlate messages for the digest.
         """)
 
+    administrative = Attribute(
+        """Flag controlling `administrivia` checks.
+
+        Administrivia tests check whether postings to the mailing list are
+        really meant for the -request address.  Examples include messages with
+        `help`, `subscribe`, `unsubscribe`, and other commands.  When such
+        messages are incorrectly posted to the general mailing list, they are
+        just noise, and when this flag is set will be intercepted and in
+        general held for moderator approval.
+        """)
+
     filter_content = Attribute(
         """Flag specifying whether to filter a message's content.
 
diff --git a/src/mailman/rest/docs/configuration.txt b/src/mailman/rest/docs/configuration.txt
index dc28c5ce9..874372478 100644
--- a/src/mailman/rest/docs/configuration.txt
+++ b/src/mailman/rest/docs/configuration.txt
@@ -17,6 +17,7 @@ All readable attributes for a list are available on a sub-resource.
     ...           'test-one@example.com/config')
     admin_immed_notify: True
     admin_notify_mchanges: False
+    administrivia: True
     advertised: True
     anonymous_list: False
     bounces_address: test-one-bounces@example.com
@@ -61,6 +62,7 @@ writable attributes in one request.
     ...           dict(
     ...             admin_immed_notify=False,
     ...             admin_notify_mchanges=True,
+    ...             administrivia=False,
     ...             advertised=False,
     ...             anonymous_list=True,
     ...             real_name='Fnords',
@@ -84,6 +86,7 @@ These values are changed permanently.
     ...           'test-one@example.com/config')
     admin_immed_notify: False
     admin_notify_mchanges: True
+    administrivia: False
     advertised: False
     anonymous_list: True
     ...
@@ -109,6 +112,7 @@ be included.  It is an error to leave one out (e.g. `pipeline`)...
     ...           dict(
     ...             #admin_immed_notify=False,
     ...             admin_notify_mchanges=True,
+    ...             administrivia=False,
     ...             advertised=False,
     ...             anonymous_list=True,
     ...             real_name='Fnords',
@@ -133,6 +137,7 @@ be included.  It is an error to leave one out (e.g. `pipeline`)...
     ...             a_mailing_list_attribute=False,
     ...             admin_immed_notify=False,
     ...             admin_notify_mchanges=True,
+    ...             administrivia=False,
     ...             advertised=False,
     ...             anonymous_list=True,
     ...             real_name='Fnords',
@@ -156,6 +161,7 @@ It is also an error to spell an attribute value incorrectly...
     ...           dict(
     ...             admin_immed_notify='Nope',
     ...             admin_notify_mchanges=True,
+    ...             administrivia=False,
     ...             advertised=False,
     ...             anonymous_list=True,
     ...             real_name='Fnords',
diff --git a/src/mailman/rest/lists.py b/src/mailman/rest/lists.py
index 5d3e68200..464b3a717 100644
--- a/src/mailman/rest/lists.py
+++ b/src/mailman/rest/lists.py
@@ -249,6 +249,7 @@ READABLE = (
     'admin_notify_mchanges',
     # Processing.
     'pipeline',
+    'administrivia',
     'filter_content',
     'convert_html_to_plaintext',
     'collapse_alternatives',
@@ -276,6 +277,7 @@ VALIDATORS = {
     'admin_notify_mchanges': as_boolean,
     # Processing.
     'pipeline': pipeline_validator,
+    'administrivia': as_boolean,
     'filter_content': as_boolean,
     'convert_html_to_plaintext': as_boolean,
     'collapse_alternatives': as_boolean,