diff --git a/PACKAGING_FRAMEWORKS b/PACKAGING_FRAMEWORKS index 4d1f572..5acd021 100644 --- a/PACKAGING_FRAMEWORKS +++ b/PACKAGING_FRAMEWORKS @@ -1,85 +1,86 @@ This is a quick description on how KDE Frameworks packaging is done. [ ] Ensure that the tags from the last release have been pushed! [ ] Ensure that the version numbers were updated long ago ("step1") [ ] Ensure everything is green at https://build.kde.org/job/Frameworks/view/Platform%20-%20SUSEQt5.12/ https://build.kde.org/job/Frameworks/view/Platform%20-%20SUSEQt5.14/ [ ] Check for regressions in oss-fuzz: https://bugs.chromium.org/p/oss-fuzz/issues/list?q=kcodecs https://bugs.chromium.org/p/oss-fuzz/issues/list?q=karchive https://bugs.chromium.org/p/oss-fuzz/issues/list?q=kimageformats [ ] ssh -A pkgframeworks@capona.kde.org, and from there: Update version file with the correct version number. Edit config, ensure dry_run=0 cd ~/release-tools/ ./increase_frameworks_version.sh step1 rm -rf sources versions REVISIONS_AND_HASHES l10n tags.git mv changelog-5* old_changelogs/ cd ../src && ./kdesrc-build --src-only && cd ../release-tools && ./list_frameworks.sh && ./update_l10n.sh ; ./increase_frameworks_version.sh step2 # takes 17 minutes [ ] In case this detected new frameworks, check that step1/step2 worked. [ ] Pack the sources: ./make_rc_tag.sh # takes 7 minutes, cannot be done from a detached or resumed screen (because of signed tags) [ ] Locally, ensure the rc tag compiles (to avoid e.g. a bad .po file breaking the build) $ edit extragear/utils/kdesrc-build/kf5-frameworks-build-include to add tag v5.12.0-rc1 in module-set frameworks $ kdesrc-build frameworks # takes 52 minutes [ ] All good, pack it up and upload it to ftpadmin@milonia.kde.org. ./pack_all.sh && ./upload_all.sh && ./generate_changelog.sh # takes 7 minutes. Upload cannot be done from a resumed screen! [ ] Clean up the changelog [ ] Generate announcement page and put it in SVN already, so translators can work on it ./create_announcement_page.sh [ ] Locally, run $ ./grab_from_scripty.sh && ./mail_release_team.sh * To update a tag+tarball after making fixes (grabbing all changes from master) (this is the lazy version of the next solution, it re-commits all po files so it's not as good) ./make_rc_tag.sh kconfigwidgets && ./pack.sh kconfigwidgets && ./upload_all.sh (and re-run ./create_sources_inc if already done) * To update a tag+tarball by cherry-picking a single fix With a script: ./make_updated_tarball.sh newrc|patchrelease The manual way: git checkout local_release (if no such branch exists, there are no translations, just pull master and tag, or make a branch for cherry-picking) git fetch ; git cherry-pick -x sha1 (or git merge origin/master) # don't use reset --hard for reverts, it would lose the translations commit git tag -a vx.y.z-rcN -m "" ; git push --tags Update N in tags.git, check version file, ./pack.sh ; ./upload_all.sh (and re-run ./create_sources_inc if already done) * cat versions/* > REVISIONS_AND_HASHES, if you want to send it all-in-one-go after updates Several days later: [ ] 8 hours before the release: $ ssh ftpadmin@milonia.kde.org "chmod a+rx ~/stable/frameworks/5.xx ; ls -l ~/stable/frameworks" [ ] ./tag_all.sh && ./create_sources_inc # takes 5 minutes (not from a resumed screen, for the git push in inqlude-data) cd ../www ; vi index.php # remove the old entry svn commit [ ] Update the version numbers right away in master [before grab_from_scripty below]. vi version ./increase_frameworks_version.sh step1 [ ] Email changelog text to kde-devel@kde.org and kde-core-devel@kde.org, and another mail to kde-announce@kde.org, by running, locally: $ ./grab_from_scripty.sh && ./mail_announcement.sh [ ] Post to the dot on https://dot.kde.org/content/contribute-story [ ] Increase KF_DISABLE_DEPRECATED_BEFORE_AND_AT= in all frameworks (to be tested locally !) - perl -pi -e 's/0x054200/0x054300/ if (/KF_DISABLE/)' */CMakeLists.txt + git_st_all + perl -pi -e 's/0x054200/0x054600/ if (/KF_DISABLE/)' */CMakeLists.txt for f in */CMakeLists.txt; do cd `dirname $f` ; git ci CMakeLists.txt -m 'GIT_SILENT increase KF_DISABLE_DEPRECATED_BEFORE_AND_AT' ; git push ; cd .. ; done To make a patchlevel release: * Use the cherry-pick procedure above. Write a short changelog by hand, run "./create_sources_inc x.y.z", commit the new info file. Edit info/kde-frameworks-*.php: mention the "known bugs" and include the new info file under the main one (in its own