Merge branch 'master' into smart_holder

docs/changelog.rst

@@ -6,8 +6,14 @@ Changelog
 Starting with version 1.8.0, pybind11 releases use a `semantic versioning
 <http://semver.org>`_ policy.
 
-v2.8.0 (WIP)
-------------
+
+IN DEVELOPMENT
+--------------
+
+
+
+v2.8.0 (Oct 4, 2021)
+--------------------
 
 New features:
 
@@ -46,13 +52,17 @@ New features:
   references instead of copies.
   `#3293 <https://github.com/pybind/pybind11/pull/3293>`_
 
+* Improve the classes generated by ``bind_map``: `#3310 <https://github.com/pybind/pybind11/pull/3310>`_
+    * Change ``.items`` from an iterator to a dictionary view.
+    * Add ``.keys`` and ``.values`` (both dictionary views).
+    * Allow ``__contains__`` to take any object.
+
 * ``pybind11::custom_type_setup`` was added, for customizing the
   ``PyHeapTypeObject`` corresponding to a class, which may be useful for
   enabling garbage collection support, among other things.
   `#3287 <https://github.com/pybind/pybind11/pull/3287>`_
 
 
-
 Changes:
 
 * Set ``__file__`` constant when running ``eval_file`` in an embedded interpreter.
@@ -106,6 +116,9 @@ Build system improvements:
 * Fix a harmless warning from CMake 3.21 with the classic Python discovery.
   `#3220 <https://github.com/pybind/pybind11/pull/3220>`_
 
+* Eigen repo and version can now be specified as cmake options.
+  `#3324 <https://github.com/pybind/pybind11/pull/3324>`_
+
 
 Backend and tidying up:
 

docs/release.rst

@@ -27,6 +27,7 @@ To release a new version of pybind11:
       ``include/pybind11/detail/common.h``. PATCH should be a simple integer.
     - Update the version HEX just below, as well.
     - Update ``pybind11/_version.py`` (match above)
+    - Run ``nox -s tests_packaging``` to ensure this was done correctly.
     - Ensure that all the information in ``setup.cfg`` is up-to-date, like
       supported Python versions.
     - Add release date in ``docs/changelog.rst``.
@@ -64,6 +65,7 @@ To release a new version of pybind11:
     - Update version macros in ``include/pybind11/detail/common.h`` (set PATCH to
       ``0.dev1`` and increment MINOR).
     - Update ``_version.py`` to match
+    - Run ``nox -s tests_packaging``` to ensure this was done correctly.
     - Add a spot for in-development updates in ``docs/changelog.rst``.
     - ``git add``, ``git commit``, ``git push``