release.rst

To release a new version of pybind11:

• Update the version number and push to pypi

  • Update pybind11/_version.py (set release version, remove 'dev').
  • Update PYBIND11_VERSION_MAJOR etc. in include/pybind11/detail/common.h.
  • Ensure that all the information in setup.py is up-to-date.
  • Update version in docs/conf.py.
  • Tag release date in docs/changelog.rst.
  • git add and git commit.
  • if new minor version: git checkout -b vX.Y, git push -u origin vX.Y
  • git tag -a vX.Y.Z -m 'vX.Y.Z release'.
  • git push
  • git push --tags.
  • python setup.py sdist upload.
  • python setup.py bdist_wheel upload.

• Get back to work

  • Update _version.py (add 'dev' and increment minor).
  • Update version in docs/conf.py
  • Update version macros in include/pybind11/common.h
  • git add and git commit. git push