Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
contribute:dev:make-a-release [2020/08/20 23:52] – [Update NEWS, Release Notes, & Translations] kevinbowencontribute:dev:make-a-release [2026/08/21 00:52] (current) – grammar improvements kevinbowen
Line 8: Line 8:
   * **[[#Post release|Post release]]**   * **[[#Post release|Post release]]**
  
-Before you start with this, make sure you understand the [[https://www.xfce.org/about/releasemodel|release model]] all developers should follow for core components.+Before you start building a new release, make sure you understand the [[https://docs.xfce.org/contribute/dev/make-a-platform-release#making_a_platform_release|release model]] all developers should follow for core components. 
 + 
 +<note important>Note that xfce provides [[https://gitlab.xfce.org/xfce/xfce4-dev-tools/-/blob/master/helpers/xfce-do-release.in|xfce-do-release]], an automated release-script which guides you through the steps required to release an Xfce component. 
 + 
 +This 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. It is best to use this over a manual release process whenever possible. 
 + 
 +Install 'xfce4-dev-tools' to make use of it !</note>
  
 ---- ----
Line 16: Line 22:
 ==== Stable releases ==== ==== Stable releases ====
  
-Stable releases are created from the stable branch of the repository. So before you start make sure you are working in this branch.+Stable releases are created from the stable branch of the repository. Before starting, make sure you are working in this branch.
  
 <file bash> <file bash>
 # get the stable branch # get the stable branch
-git checkout --track -b xfce-4.14 remotes/origin/xfce-4.14+git checkout --track -b xfce-4.20 remotes/origin/xfce-4.20
  
 # pull the latest changes # pull the latest changes
Line 28: Line 34:
 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. 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.20.2 becomes 4.20.3.
  
 ==== 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.15.0, then 4.15.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.21.0, then 4.21.1 etc.
  
 [[|Back to Top]] [[|Back to Top]]
Line 45: Line 51:
 As of Xfce version 4.15.0, [[https://gitlab.xfce.org/xfce/xfce4-dev-tools|xfce-dev-tools]] contains several Bash helper scripts to assist in building your release:  As of Xfce version 4.15.0, [[https://gitlab.xfce.org/xfce/xfce4-dev-tools|xfce-dev-tools]] contains several Bash helper scripts to assist in building your release: 
  
-  * **[[https://gitlab.xfce.org/xfce/xfce4-dev-tools/-/blob/master/helpers/xfce-do-release|xfce-do-release]] ** +  * **[[https://gitlab.xfce.org/xfce/xfce4-dev-tools/-/blob/master/helpers/xfce-do-release|xfce-do-release]] ** - Main helper script. Checks versions, tags, commits and pushes changes, logs into and uploads to release manager. 
-  * **[[https://gitlab.xfce.org/xfce/xfce4-dev-tools/-/blob/master/helpers/xfce-get-release-notes|xfce-get-release-notes]] ** +  * **[[https://gitlab.xfce.org/xfce/xfce4-dev-tools/-/blob/master/helpers/xfce-get-release-notes|xfce-get-release-notes]] ** - Complementary to xfce-get-translations and gets all the commits that aren't translation updates. 
-  * **[[https://gitlab.xfce.org/xfce/xfce4-dev-tools/-/blob/master/helpers/xfce-get-translations|xfce-get-translations]] **+  * **[[https://gitlab.xfce.org/xfce/xfce4-dev-tools/-/blob/master/helpers/xfce-get-translations|xfce-get-translations]] ** - Gets all language updates to a repository since a specified commit or tag.
   * **[[https://gitlab.xfce.org/xfce/xfce4-dev-tools/-/blob/master/helpers/xfce-update-news|xfce-update-news]] **   * **[[https://gitlab.xfce.org/xfce/xfce4-dev-tools/-/blob/master/helpers/xfce-update-news|xfce-update-news]] **