This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "CMake".
The branch, master has been updated via fdc9fadef5d585a74c0ee80e0b376d20ea19f835 (commit) via 4542ec239a3ff46d133267b5492ae4c64d163844 (commit) from 8ce189720ee8daafed4848ee9eb970f9e0546578 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- https://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=fdc9fadef5d585a74c0ee80e0b376d20ea19f835 commit fdc9fadef5d585a74c0ee80e0b376d20ea19f835 Merge: 8ce1897 4542ec2 Author: Craig Scott <craig.sc...@crascit.com> AuthorDate: Fri Jul 26 22:57:46 2019 +0000 Commit: Kitware Robot <kwro...@kitware.com> CommitDate: Fri Jul 26 18:57:59 2019 -0400 Merge topic 'doc-maint-create-release' 4542ec239a Help/dev: Add release commit instructions to maintainer guide Acked-by: Kitware Robot <kwro...@kitware.com> Merge-request: !3604 https://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=4542ec239a3ff46d133267b5492ae4c64d163844 commit 4542ec239a3ff46d133267b5492ae4c64d163844 Author: Brad King <brad.k...@kitware.com> AuthorDate: Fri Jul 26 12:31:05 2019 -0400 Commit: Brad King <brad.k...@kitware.com> CommitDate: Fri Jul 26 14:34:09 2019 -0400 Help/dev: Add release commit instructions to maintainer guide diff --git a/Help/dev/maint.rst b/Help/dev/maint.rst index 75a1d68..37a1d3a 100644 --- a/Help/dev/maint.rst +++ b/Help/dev/maint.rst @@ -92,6 +92,45 @@ Publish both ``master`` and ``release`` simultaneously: .. _`CMake Review Process`: review.rst .. _`CMake CDash Page`: https://open.cdash.org/index.php?project=CMake +Create Release Version +====================== + +When the ``release`` branch is ready to create a new release, follow the +steps in the above `Maintain Current Release`_ section to checkout a local +``release-$ver`` branch, where ``$ver`` is the version number of the +current release in the form ``$major.$minor``. + +Edit ``Source/CMakeVersion.cmake`` to set the full version: + +.. code-block:: cmake + + # CMake version number components. + set(CMake_VERSION_MAJOR $major) + set(CMake_VERSION_MINOR $minor) + set(CMake_VERSION_PATCH $patch) + #set(CMake_VERSION_RC $rc) # uncomment for release candidates + +In the following we use the placeholder ``$fullver`` for the full version +number of the new release with the form ``$major.$minor.$patch[-rc$rc]``. +If the version is not a release candidate, comment out the RC version +component above and leave off the ``-rc$rc`` suffix from ``$fullver``. + +Commit the release version with the **exact** message ``CMake $fullver``: + +.. code-block:: shell + + git commit -m "CMake $fullver" + +Tag the release using an annotated tag with the same message as the +commit and named with the **exact** form ``v$fullver``: + +.. code-block:: shell + + git tag -s -m "CMake $fullver" "v$fullver" + +Follow the steps in the above `Maintain Current Release`_ section to +merge the ``release-$ver`` branch into ``master`` and publish both. + Branch a New Release ==================== ----------------------------------------------------------------------- Summary of changes: Help/dev/maint.rst | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) hooks/post-receive -- CMake _______________________________________________ Cmake-commits mailing list Cmake-commits@cmake.org https://cmake.org/mailman/listinfo/cmake-commits