Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
contribute:dev:make-a-release [2018/01/03 18:45] – [Update version number] skunnyk | contribute:dev:make-a-release [2023/02/24 10:04] (current) – [Making a Release] skunnyk | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ~~NOTOC~~ | ||
====== Making a Release ====== | ====== Making a Release ====== | ||
- | Before you start with this, make sure you understand the [[http:// | + | * **[[# |
+ | * **[[#Build the tarball|Build the tarball]]** | ||
+ | * **[[#Tag release|Tag release]]** | ||
+ | * **[[#Upload the tarball|Upload the tarball]]** | ||
+ | * **[[#Post release|Post release]]** | ||
+ | |||
+ | Before you start with this, make sure you understand the [[https:// | ||
+ | |||
+ | <note important> | ||
+ | |||
+ | That prevents mistakes and helps to get a clean build (by building in a container). It will catch all translation updates and pre-write a NEWS file for you by using the commit messages. Best use it over the manual release process when possible. | ||
+ | |||
+ | Install ' | ||
+ | |||
+ | ---- | ||
===== Version Numbering ===== | ===== Version Numbering ===== | ||
Line 11: | Line 26: | ||
<file bash> | <file bash> | ||
# get the stable branch | # get the stable branch | ||
- | git checkout --track -b xfce-4.12 remotes/ | + | git checkout --track -b xfce-4.14 remotes/ |
# pull the latest changes | # pull the latest changes | ||
Line 17: | Line 32: | ||
</ | </ | ||
- | Now make sure all the bug fixes are committed and pushed to the remote repository. You can check this at [[http://git.xfce.org|git.xfce.org]] as well. | + | Now make sure all the bug fixes are committed and pushed to the remote repository. You can check this at [[http://gitlab.xfce.org|gitlab.xfce.org]] as well. |
For the version number the //micro// version is increased by 1. So 4.12.2 becomes 4.12.3. | For the version number the //micro// version is increased by 1. So 4.12.2 becomes 4.12.3. | ||
Line 23: | Line 38: | ||
==== Development releases ==== | ==== Development releases ==== | ||
- | Unstable releases are created from the master branch, which is in this period in feature-freeze. There we use an odd //minor// number. So the first development release is for example 4.11.0, then 4.11.1 etc. | + | Unstable releases are created from the master branch, which is in this period in feature-freeze. There we use an odd //minor// number. So the first development release is for example 4.15.0, then 4.15.1 etc. |
+ | |||
+ | [[|Back to Top]] | ||
+ | ---- | ||
===== Build the tarball ===== | ===== Build the tarball ===== | ||
Line 29: | Line 47: | ||
If you are sure all the fixes are committed in the correct branch, its time to prepare the release. | If you are sure all the fixes are committed in the correct branch, its time to prepare the release. | ||
- | ==== Update NEWS ==== | + | ==== Update NEWS, Release Notes, & Translations |
+ | |||
+ | As of Xfce version 4.15.0, [[https:// | ||
- | Update the NEWS, AUTHORS, README, THANKS, HACKING etc. files to credits are given where due. | + | * **[[https:// |
+ | * **[[https:// | ||
+ | * **[[https:// | ||
+ | * **[[https:// | ||
==== Update version number ==== | ==== Update version number ==== | ||
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | ==== Update the ChangeLog ==== | ||
- | |||
- | All core modules have a '' | ||
- | |||
- | <file bash> | ||
- | # put the git log in ChangeLog | ||
- | git log > ChangeLog | ||
- | |||
- | # commit | ||
- | git commit ChangeLog -m " | ||
- | |||
- | # send to remote | ||
- | git push | ||
- | </ | ||
==== Compile the code ==== | ==== Compile the code ==== | ||
Line 62: | Line 71: | ||
If everything is ok // | If everything is ok // | ||
+ | |||
+ | [[|Back to Top]] | ||
+ | ---- | ||
===== Tag release ===== | ===== Tag release ===== | ||
- | If the tarball is build successfully, | + | If the tarball is build successfully, |
<file bash> | <file bash> | ||
Line 78: | Line 90: | ||
# send tag to remote | # send tag to remote | ||
- | git push --tags | + | git push --tags |
</ | </ | ||
- | For more information read the [[http:// | + | For more information read the [[https:// |
+ | |||
+ | [[|Back to Top]] | ||
+ | ---- | ||
===== Upload the tarball ===== | ===== Upload the tarball ===== | ||
Line 91: | Line 106: | ||
* Please note that you MUST subscribe to the announce mailling list before doing a release. Your first release mail need to be moderated by a list admin. | * Please note that you MUST subscribe to the announce mailling list before doing a release. Your first release mail need to be moderated by a list admin. | ||
- Make a nice summary of the new features or just paste the contents of the '' | - Make a nice summary of the new features or just paste the contents of the '' | ||
+ | |||
+ | [[|Back to Top]] | ||
+ | ---- | ||
===== Post release ===== | ===== Post release ===== | ||
- Add the '' | - Add the '' | ||
- | - Don't forget to add the version to your project on [[http:// | ||
- Possibly switch back to the '' | - Possibly switch back to the '' | ||
- Celebrate | - Celebrate | ||
+ | [[|Back to Top]] | ||
+ | ---- | ||
+ | [[: |