Overview

Artifact ID:	6ce7e37d5cd7d0d9ae0559d55c05236d908eab00b901ba5edb8c4e2f1b7cc714
Page Name:	Release process
Date:	2024-07-06 11:08:37
Original User:	js
Mimetype:	text/x-markdown
Parent:	fda4de78d5c4bea571a597efd33dd3d0a54693876fe7b8c4b48a5d13a6ffecda (diff)
Next	f778fc4f04a31a9d023690a73cdeb086253561fcce1e06e9c61274860fc65261

Content

Release process

Update the ChangeLog and cherry-pick the change into trunk.
Make sure the library version has been increased for all libraries that had changes / bug fixes! Don't forget to increase the minor for every library that had new features added and the patch level for every library that had bug fixes!
Change the version in AC_INIT and the BUNDLE_VERSION in configure.ac and commit. This commit should have the ${version}-release tag!
Push and make sure the tag propagates to Git as well.
Run fossil up ${version}-release and run fossil clean -x -v, then ./autogen.sh && ./configure. Don't forget this, or the version might be wrong!
Generate and sign tarballs using make release.
Extract objfw-${version}.tar.gz and objfw-docs-${version}.tar.gz as well as objfw-${previousVersion}.tar.gz and objfw-docs-${previousVersion}.tar.gz. Then diff the current against the previous version and check nothing unexpected is in there.
Upload the tarballs and their signatures.
Extract the new documentation and put it here.
Update the LATEST symlink.
Update the Releases page.
Update the News page.
Announce the new release on the Fediverse.
Announce the new release in the Matrix room and change the topic to include the new release.

Distributions

Repology is great for tracking what distribution is at what version, though it is neither exhaustive nor always update to date.

In devel/objfw:

Edit Makefile to increase version.
Run make makesum to update distinfo. Check it is correct.
Run make package.
Run make print-PLIST >PLIST to update the PLIST. Look at the diff and fix any custom PLIST entries that this reverted. Pay attention to what is already in the other PLIST.* files!
Commit (include the change log in the commit message) and run make cce.

Make sure to be on rawhide.
Increase version in objfw.spec and git add it.
Download the tarball and signature via spectool -g objfw.spec.
fedpkg upload both objfw-${version}.tar.gz and objfw-${version}.tar.gz.sig.
Remove the old version from sources and .gitignore, then git add both.
git commit -m "Update to ${version}"
for i in f39 f40 epel8 epel9; do git checkout $i && git merge main; done
git push
for i in rawhide f39 f40 epel8 epel9; do git checkout $i && fedpkg build --nowait; done
Wait for the builds to be done, then create the updates on Bodhi. Set the Karma required to 1.

Edit the PKGBUILD file to increase the version and update the hash.
Commit with the message objfw: Update to ${version} and create a draft pull request. This will trigger CI.
Once CI passed, click on Ready for review.

Edit the Makefile to increase the version and update the hash.
If a library minor increased, the *.p5m files need to be changed as well.
Run gmake sample-manifest, gmake publish, gmake test and gmake REQUIRED_PACKAGES.
Commit with the message library/objfw: update to ${version} and create a pull request.

Edit the APKBUILD to increase the version and update the file name and hash.
Commit with the message community/objfw: upgrade to ${version} and create a draft pull request. This will trigger CI.
(Optional) Manually trigger the RISC-V build.
Once CI passed, click on Mark as ready.
Only for bug fix-only releases: Repeat the same for every stable branch, but prefix the commit message with the branch, e.g. [3.19] community/objfw: upgrade to 1.0.6.

In dev-libs/objfw:

In devel/objfw:

Edit Makefile and increase the version and potentially library versions.
Run make makesum.
Run make update-plist to update the PLIST. Look at the diff and revert any unwanted diffs.
Run cvs diff and send the output to ports@openbsd.org.

In devel/objfw: