= Release Guidelines = '''All next steps described at this page should be mirrored in release tickets step-by-step''' Search previously created ticket with task about next version release (create if ticket not found) and follow by steps while preparing for the release: * download PO-translations from Transifex.net by command [http://help.transifex.net/features/client/index.html tx]{{{ pull --all}}} (see before: [wiki:TxRepoSetup how to set up local tx-repository]) '''NOTE:''' keep the po/ru.po file unmodified while updated from Transifex. * store translations in git repo by following commands: {{{ cp -f $TX_REPO/master/*.po $GIT_REPO/po cd $GIT_REPO/po ./strip-location.sh *.po git add *.po git commit -s -m 'Updated translations from Transifex' git push origin master }}} * download the hint translations from Transifex.net by command: {{{MC_SOURCE_ROOT_DIR=$(pwd) maint/utils/sync-transifex/mc.hint-fromTransifex.sh}}} * store translations in git repo by following commands: {{{ git add doc/hints/l10n/mc.hint.* git commit -s -m 'Updated the hints translations from Transifex' git push origin master }}} * create new NEWS wiki page for next version with empty template. Template may be copied from current NEWS wiki page (without list of tasks and bugreports); * add content of current NEWS wiki page to the doc/NEWS file in git repo. Save it in git by following commands: {{{ git add doc/NEWS git commit -s -m 'Updated doc/NEWS file' git push origin master }}} * create new tag in git by command (see before: [wiki:GpgSetUpForSigningReleases how to set up your gpg key for signing releases]) {{{ git tag -s # keep 'Release' comment git push origin }}} * new version in Trac; * new milestone in Trac * create tar.(bz2|xz) package files: {{{ ./autogen.sh stop mkdir dist; cd dist; ../configure && make dist-bzip2 && make dist-xz }}} * make checksums for archives: {{{ sha256sum mc-*tar.* > mc-{version}.sha256 }}} * upload source packages and checksums to the special upload area; * developers should download tarballs, verify checksums, compile and locally install. If everything is ok than developers keep votes in ticket; * upload source packages and checksums to midnightcommander@ftp-osl.osuosl.org/home/midnightcommander/data (all maintainers have access via pubkeys); * run command: {{{ssh midnightcommander@ftp-osl.osuosl.org '/home/midnightcommander/trigger-midnightcommander'}}} * update Wiki start page with latest release number; * write an announcement: list user visible changes (bugs and features); * close current milestone; * create new ticket (type=task, component=adm) for the next release; * close ticket for release. === Notes: === * Cleanup branch should be named as XXXX_cleanup; where XXXX it's a number of current release ticket. * The cleanup branch should be created by demand and should be voted and merged to main branch ASAP. Don't keep the cleanup branch in development stage longer that it needed. * Activity around cleanup branch should occur in release ticket. * Cleanup branch should be deleted after merging to main branch. Cleanup branch may be recreated with same name with any count of times. * Cleanup branch shouldn't be merged to main branch in a week before release (all changes should be moved to cleanup branch for next release)