notcurses/doc/release-checklist.md

Release procedure

Precheck

• Review the testing checklist (doc/testing-checklist.md)
• clang-tidy check with something like:
  • cmake "-DCMAKE_CXX_CLANG_TIDY=/usr/bin/clang-tidy-15\;-checks=-*,clang-analyzer-*,modernize-*,performance-*" .. or
  • scan-build cmake .. && scan-build make
• Verify that rust + python compile

Release

• In toplevel, run tools/release.sh $OLDVERSION $VERSION "quip":
  • Cleans repo with git clean -f -d -x
  • Opens an editor to finalize NEWS.md
  • Bumps version numbers everywhere they need bumping
  • Commits changes, tags result with v$VERSION, pushes tag
  • Downloads new tarball and signs it
  • Uploads signature to github
  • Uploads new Rust crates with cargo publish
  • Uploads new Python pip with
    • python3 setup.py sdist
    • twine upload dist/*
  • Generates and uploads new HTML documentation via make html
    • scp *.html ../doc/man/index.html qemfd.net:/var/www/notcurses/
    • scp -r html qemfd.net:/var/www/notcurses/
  • Publishes new release at https://github.com/dankamongmen/notcurses/releases
    • Title is "v$VERSION—some quip"

Packaging

Debian

• In gbp repository, run tools/debrelease.sh $VERSION:
  • Updates Debian changelog with dch -v $VERSION+dfsg.1-1
  • Finalizes Debian changelog with dch -r
  • Repacks DFSG-safe tarball with uscan:
    • uscan --repack --compression xz --force
    • gpg --sign --armor --detach-sign ../notcurses_$VERSION+dfsg.1.orig.tar.xz
  • Uploads repack + signature to github
  • imports new version: gbp import-orig ../notcurses_$VERSION+dfsg.1.orig.tar.xz
  • git push --tags
  • builds source package: dpkg-buildpackage --build=source
  • builds binaries: cd .. && export TERM=xterm-256color && sudo pbuilder build *dsc
    • performs this in xterm with TERM=xterm-256color
    • beware: freak TERMs won't be present in pbuilder

Fedora

• In pagure/notcurses rawhide:
  • Update notcurses.spec, bump version, add changelog entry
  • clear out any old ersatz detritus
  • spectool -g notcurses.spec
  • fedpkg upload *.xz *.asc
  • fedpkg new-sources *.xz *.asc
  • fedpkg commit
  • git push
  • fedpkg build
  • for each active branch:
    • fedpkg switch-branch f32
    • git merge rawhide

Arch

• Upload new AUR information
  • Update pkgver and sha256sums entries
  • makepkg --printsrcinfo > .SRCINFO
  • Test that package builds with makepkg
  • git commit -a

Alpine

• Update version in APKBUILD
  • Run abuild checksum to get new checksums
  • abuild -r to test APKBUILD
  • create merge request

FreeBSD

• Update svn checkout of Ports tree: cd /usr/ports && svn up
• Upgrade ports: portupgrade -uap
• cd /usr/ports/devel/notcurses
• Update DISTVERSION in `Makefile
• sudo make makesum
• make stage
• make stage-qa
• portlint
• svn diff > ../make -VPKGNAME`.diff
• File bug on devel/notcurses, attach diff