- prepare release 4.8.2

CHANGES.rst

@@ -6,7 +6,7 @@ These are all the changes in Zope 4, starting with the alpha releases.
 The change log for the previous version, Zope 2.13, is at
 https://zope.readthedocs.io/en/2.13/CHANGES.html
 
-4.8.2 (unreleased)
+4.8.2 (2022-06-01)
 ------------------
 
 - Update ``waitress`` to version 2.1.2.

docs/maintenance.rst

@@ -38,44 +38,40 @@ Steps for creating a new Zope release
 
 - Garden the change log and check it for spelling issues.
 
-- Check the future PyPI long description for ReST errors::
+- Check the future PyPI long description for ReST errors (example for macOS)::
 
-  $ bin/longtest
+  $ cat README.rst <(echo) CHANGES.rst | bin/rst2html.py >/tmp/test.html && open /tmp/test.html
 
 - Check in the changes.
 
-- Update version information in change log and ``setup.py``::
-
-  $ bin/prerelease
+- Update version information in change log and ``setup.py`` and specify today's
+  date as release date in the change log.
 
 - Pin the Zope version in ``versions-prod.cfg``
 
 - Run ``bin/python util.py`` to update ``requirements-full.txt``. **Note:** The
   script will only run on Python 3.7 or higher!
 
-- Commit the changes.
-
 - Run all tests::
 
   $ bin/tox -pall
 
-- Upload the tagged release to PyPI::
-
-    $ bin/release
+- If the tests succeed, commit the changes.
 
-    or
+- Upload the tagged release to PyPI::
 
     $ git tag -as <TAG-NAME> -m "- tagging release <TAG-NAME>"
     $ git push --tags
     $ bin/zopepy setup.py egg_info -Db '' sdist bdist_wheel
     $ bin/twine upload -s dist/Zope-<TAG-NAME>*
 
-- Update version information::
+- Update version information in the change log and ``setup.py`` and revert the
+  version pin for Zope::
 
-  $ bin/postrelease
-  $ vi versions-prod.cfg (set version pin of Zope back to ``< 5``)
-  $ bin/python util.py
-  $ bin/buildout
+    $ vim CHANGES.rst setup.py
+    $ vim versions-prod.cfg (set version pin of Zope back to ``< 5``)
+    $ bin/python util.py
+    $ bin/buildout
 
 - Commit and push the changes.
 

requirements-full.txt

@@ -1,4 +1,4 @@
-Zope==<5
+Zope==4.8.2
 AccessControl==4.3
 Acquisition==4.10
 AuthEncoding==4.3

setup.py

@@ -29,7 +29,7 @@ def _read_file(filename):
 README = _read_file('README.rst')
 CHANGES = _read_file('CHANGES.rst')
 
-version = '4.8.2.dev0'
+version = '4.8.2'
 
 
 setup(

versions-prod.cfg

@@ -2,7 +2,7 @@
 # Version pins for required and commonly used dependencies.
 
 [versions]
-Zope = <5
+Zope = 4.8.2
 Zope2 = 4.0
 # AccessControl 5+ no longer supports Zope 4.
 AccessControl = 4.3