Release metadata lives in version.mk. The tag must be v followed by that
exact version; CI rejects a mismatch before building.
-
Update
VERSIONandDATEinversion.mk. -
Update the
$VERline inpackage/Help/Host-Tools.guide. -
Move the pending changelog entry from
Unreleasedto the release date and update its comparison link to end at the release tag instead ofHEAD. -
Run the complete release build from a clean tree, in the image CI uses. Take the digest-pinned image reference from the
container:line in.github/workflows/build.yml; the plain tag may point at a newer compiler. The image has no native C compiler, so install one for the unit tests:image="amigadev/crosstools:m68k-amigaos@sha256:<digest from build.yml>" docker run --rm -v "$PWD":/work -w /work "$image" sh -c \ 'apt-get update -qq && apt-get install -y -qq --no-install-recommends "gcc-$(uname -m | tr _ -)-linux-gnu" && make clean test package'
-
Confirm that
git status --shortcontains only intentional source changes.make packagealready verifies the package layout and all release version strings before writing the archive. -
Review the archive and checksum locally if desired:
lha l "Host-Tools-$(make -s print-version).lha" shasum -a 256 "Host-Tools-$(make -s print-version).lha"
-
Merge the release pull request, then create and push the matching annotated tag:
version="$(make -s print-version)" git tag -a "v$version" -m "Host-Tools v$version" git push origin "v$version"
The tag workflow rebuilds and verifies the package, publishes the .lha and
.lha.sha256 artifacts, and creates the GitHub release with generated notes.
The detailed wiki pages are authored in docs/wiki/, not in the wiki editor.
Publish them when their content changes, after the corresponding repository
change is merged; keep the release archive's README and AmigaGuide usable
offline. The GitHub wiki is a separate Git repository, so merging this
repository does not update the live wiki:
gh repo clone BlitterStudio/host-tools.wiki ../host-tools.wiki
cp docs/wiki/*.md ../host-tools.wiki/
git -C ../host-tools.wiki add Home.md Getting-Started.md Command-Tools.md Audio-and-MP3.md
git -C ../host-tools.wiki commit -m "Update Host-Tools user guides"
git -C ../host-tools.wiki pushClone only once; for subsequent updates, pull the wiki's latest commit before copying the pages. The first page of a new wiki must be created in GitHub's wiki editor before its Git repository can be cloned.