2 files changed, 8 insertions, 6 deletions

diff --git a/src/mailman/handlers/docs/archives.rst b/src/mailman/handlers/docs/archives.rst
index 323d121e8..abaad9f52 100644
--- a/src/mailman/handlers/docs/archives.rst
+++ b/src/mailman/handlers/docs/archives.rst
@@ -26,7 +26,8 @@ should *not* get archived.
 
 For example, no digests should ever get archived.
 
-    >>> mlist.archive = True
+    >>> from mailman.interfaces.archiver import ArchivePolicy
+    >>> mlist.archive_policy = ArchivePolicy.public
     >>> msg = message_from_string("""\
     ... Subject: A sample message
     ...
@@ -39,7 +40,7 @@ For example, no digests should ever get archived.
 If the mailing list is not configured to archive, then even regular deliveries
 won't be archived.
 
-    >>> mlist.archive = False
+    >>> mlist.archive_policy = ArchivePolicy.never
     >>> handler.process(mlist, msg, {})
     >>> switchboard.files
     []
@@ -49,7 +50,7 @@ want to be archived.  We've seen both in the wild so both are supported.  The
 ``X-No-Archive:`` header can be used to indicate that the message should not
 be archived.  Confusingly, this header's value is actually ignored.
 
-    >>> mlist.archive = True
+    >>> mlist.archive_policy = ArchivePolicy.public
     >>> msg = message_from_string("""\
     ... Subject: A sample message
     ... X-No-Archive: YES
diff --git a/src/mailman/handlers/docs/rfc-2369.rst b/src/mailman/handlers/docs/rfc-2369.rst
index 7eda388c1..7064de6bd 100644
--- a/src/mailman/handlers/docs/rfc-2369.rst
+++ b/src/mailman/handlers/docs/rfc-2369.rst
@@ -7,7 +7,8 @@ headers generally start with the `List-` prefix.
 
     >>> mlist = create_list('test@example.com')
     >>> mlist.preferred_language = 'en'
-    >>> mlist.archive = False
+    >>> from mailman.interfaces.archiver import ArchivePolicy
+    >>> mlist.archive_policy = ArchivePolicy.never
 
 ..
     This is a helper function for the following section.
@@ -171,7 +172,7 @@ Archive headers
 When the mailing list is configured to enable archiving, a `List-Archive`
 header will be added.
 
-    >>> mlist.archive = True
+    >>> mlist.archive_policy = ArchivePolicy.public
 
 `RFC 5064`_ defines the `Archived-At` header which contains the url to the
 individual message in the archives.  Archivers which don't support
@@ -208,7 +209,7 @@ If the mailing list isn't being archived, neither the `List-Archive` nor
 `Archived-At` headers will be added.
 
     >>> config.pop('prototype')
-    >>> mlist.archive = False
+    >>> mlist.archive_policy = ArchivePolicy.never
     >>> msg = message_from_string("""\
     ... From: aperson@example.com
     ...