====== Xfce Release How To ====== Please see https://docs.xfce.org/contribute/dev/start for an up to date documentation! ===== Considerations before releasing ===== * Are the translations up to date, are the translator aware of you going to release. * All patches are applied and all known critical bugs fixed. * Do you have the feeling: "Yes, this code ready to be released upon the world, everyone should be able to enjoy it"? ;) ===== Files to update before release ===== - Release information: ''ChangeLog'', ''NEWS''. - Common information: ''README'', ''AUTHORS'', ''THANKS'', ''TODO'' (when present). - [[http://git.xfce.org/xfce/xfce4-power-manager/commit/?id=10e532b0c6462cfa61faa5ebeddec7b7e454bfe3|Sample Commit]] ===== Configure script ===== - Edit the configure script template ''configure.in.in'' or ''configure.ac.in''. - Set the package version (''_version_major'', ''_version_minor'' and ''_version_micro'') to the version you want to release. - Remove ''git'' from ''_version_tag''. - Check the build dependencies. ===== Check release package ===== - Run ''./autogen.sh'' - Run ''make distcheck'' - Check auto generated files: ''INSTALL'', ''COPYING'' - If at this stage everything works, run ''git commit -m 'Updates for release''' - Now you are ready to tag the current master: \\ git tag -a - # e.g. xfce4-power-manager-1.3.2 git push && git push --tagsYou can sign tags with a GPG key by adding an additional parameter to the ''git tag'' command. For more information about tagging read the ''[[http://www.kernel.org/pub/software/scm/git/docs/git-tag.html|git-tag]]'' manual. - Now you can release the package using the [[https://releases.xfce.org|xfce release manager]]. Folow the instructions on that site. ===== Post-release ===== - Edit ''configure.in.in'' or ''configure.ac.in''. - Reset ''_version_tag'' to ''git''. - Commit (''git commit -m "Back to development"'') and push. - Add the version to the bugzilla component.