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 [2019/05/16 14:16] – [Tag release] skunnykcontribute: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://www.xfce.org/about/releasemodel|release model]] all developers should follow for core components.+  * **[[#Version Numbering|Version Numbering]]** 
 +  * **[[#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://www.xfce.org/about/releasemodel|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 all steps required to release a xfce component. 
 + 
 +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 'xfce4-dev-tools' to make use of it !</note> 
 + 
 +----
  
 ===== 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/origin/xfce-4.12+git checkout --track -b xfce-4.14 remotes/origin/xfce-4.14
  
 # pull the latest changes # pull the latest changes
Line 17: Line 32:
 </file> </file>
  
-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://gitlab.xfce.org/xfce/xfce4-dev-tools|xfce-dev-tools]] contains several Bash helper scripts to assist in building your release: 
  
-Update the NEWS, AUTHORS, README, THANKS, HACKING etc. files to credits are given where due.+  * **[[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]] ** - 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]] ** - 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]] **
  
 ==== Update version number ==== ==== Update version number ====
 +
   - Edit the configure script template configure.ac.in.     - Edit the configure script template configure.ac.in.  
   - Set the package version (<package>_version_major, <package>_version_minor and <package>_version_micro) to the version you want to release.     - Set the package version (<package>_version_major, <package>_version_minor and <package>_version_micro) to the version you want to release.  
Line 39: Line 63:
   - Check the build dependencies.    - Check the build dependencies. 
  
-==== Update the ChangeLog ==== 
- 
-All core modules have a ''Makefile.am'' rule to generate the ''ChangeLog'' during //distcheck//. If this is not the case, add the rule to the Makefile.am file (see https://git.xfce.org/xfce/libxfce4ui/tree/Makefile.am#n20 for an example) 
 ==== Compile the code ==== ==== Compile the code ====
  
Line 50: Line 71:
  
 If everything is ok //distcheck// will tell you the ''abc.x.y.z.tar.bz2'' tarball is ready. If not fix the error(s) and commit the changes before running //distcheck// again. If everything is ok //distcheck// will tell you the ''abc.x.y.z.tar.bz2'' tarball is ready. If not fix the error(s) and commit the changes before running //distcheck// again.
 +
 +[[|Back to Top]]
 +----
  
 ===== Tag release ===== ===== Tag release =====
  
-If the tarball is build successfully, it is time to tag the release in GIT.+If the tarball is build successfully, it is time to tag the release in git.
  
 <file bash> <file bash>
Line 69: Line 93:
 </file> </file>
  
-For more information read the [[http://git-scm.com/docs/git-tag|git tag manual]].+For more information read the [[https://git-scm.com/docs/git-tag|git tag manual]]. 
 + 
 +[[|Back to Top]] 
 +----
  
 ===== Upload the tarball ===== ===== Upload the tarball =====
Line 79: 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 ''NEWS'' file.   - Make a nice summary of the new features or just paste the contents of the ''NEWS'' file.
 +
 +[[|Back to Top]]
 +----
  
 ===== Post release ===== ===== Post release =====
  
   - Add the ''git'' back to ?_version_tag() in the ''configure.am.in'' file, commit and push the change.   - Add the ''git'' back to ?_version_tag() in the ''configure.am.in'' file, commit and push the change.
-  - Don't forget to add the version to your project on [[https://bugzilla.xfce.org/]]. 
   - Possibly switch back to the ''master'' branch.   - Possibly switch back to the ''master'' branch.
-  - Add the version to the bugzilla component. 
   - Celebrate  8-).   - Celebrate  8-).
  
 +[[|Back to Top]]
 +----
 +[[:contribute:dev:start:|Back to main Xfce Development Information page]]