Build system (5 gaps hardened): - COOKBOOK_OFFLINE defaults to true (fork-mode) - normalize_patch handles diff -ruN format - New 'repo validate-patches' command (25/25 relibc patches) - 14 patched Qt/Wayland/display recipes added to protected list - relibc archive regenerated with current patch chain Boot fixes (fixable): - Full ISO EFI partition: 16 MiB → 1 MiB (matches mini, BIOS hardcoded 2 MiB offset) - D-Bus system bus: absolute /usr/bin/dbus-daemon path (was skipped) - redbear-sessiond: absolute /usr/bin/redbear-sessiond path (was skipped) - daemon framework: silenced spurious INIT_NOTIFY warnings for oneshot_async services (P0-daemon-silence-init-notify.patch) - udev-shim: demoted INIT_NOTIFY warning to INFO (expected for oneshot_async) - relibc: comprehensive named semaphores (sem_open/close/unlink) replacing upstream todo!() stubs - greeterd: Wayland socket timeout 15s → 30s (compositor DRM wait) - greeter-ui: built and linked (header guard unification, sem_compat stubs removed) - mc: un-ignored in both configs, fixed glib/libiconv/pcre2 transitive deps - greeter config: removed stale keymapd dependency from display/greeter services - prefix toolchain: relibc headers synced, _RELIBC_STDLIB_H guard unified Unfixable (diagnosed, upstream): - i2c-hidd: abort on no-I2C-hardware (QEMU) — process::exit → relibc abort - kded6/greeter-ui: page fault 0x8 — Qt library null deref - Thread panics fd != -1 — Rust std library on Redox - DHCP timeout / eth0 MAC — QEMU user-mode networking - hwrngd/thermald — no hardware RNG/thermal in VM - live preload allocation — BIOS memory fragmentation, continues on demand
3.3 KiB
dbus release checklist
To make a release of D-Bus, do the following:
-
check out a fresh copy from Git
-
verify that the libtool versioning/library soname in
meson.buildis changed if it needs to be, or not changed if not- CMake takes the version number from
meson.buildand so should not need updating
- CMake takes the version number from
-
update the file NEWS based on the git history
-
verify that the version number of dbus-specification.xml is changed if it needs to be; if changes have been made, update the release date in that file
-
update the AUTHORS file with
ninja -C ${builddir} maintainer-update-authorsif necessary -
the version number in
meson.buildshould have major.minor.micro, even if micro is 0, i.e. "1.0.0" and "1.2.0" not "1.0"/"1.2"; the micro version should be even for releases, and odd for intermediate snapshots- CMake takes the version number from
meson.buildand so should not need updating
- CMake takes the version number from
-
When ready to release,
git commit -a. This is the version of the tree that corresponds exactly to the released tarball. -
meson dist -C ${builddir)(this is the equivalent of Autotoolsmake distcheck) -
if
meson distfailed, fix it, commit, retry until successful -
tag the tree with
git tag -s -m 'Released X.Y.Z' dbus-X.Y.Zwhere X.Y.Z is the version of the release. If you can't sign then simply created an unsigned annotated tag:git tag -a -m 'Released X.Y.Z' dbus-X.Y.Z. -
bump the version number up in
meson.buildagain (so the micro version is odd), and commit it. Make sure you do this after tagging the previous release! The idea is that git has a newer version number than anything released. Similarly, bump the version number of dbus-specification.xml and set the release date to "(not finalized)". -
push your changes and the tag to the central repository with
git push --atomic origin main dbus-X.Y dbus-X.Y.Z -
scp your tarball to freedesktop.org server and copy it to
dbus.freedesktop.org:/srv/dbus.freedesktop.org/www/releases/dbus/. This should be possible if you're in group "dbus" -
Update the online documentation with
ninja -C ${builddir} maintainer-upload-docs. -
If
doc/busconfig.dtdand/ordoc/introspect.dtdhave changed, send a merge request toxdg-specssimilar to https://gitlab.freedesktop.org/xdg/xdg-specs/90 to get the new version published -
post to dbus@lists.freedesktop.org announcing the release.
Making a ".0" stable release
We create a branch for each stable release. The branch name should be dbus-X.Y which is a branch that has releases versioned X.Y.Z; changes on a stable branch should be limited to significant bug fixes.
Because we won't make minor changes like keeping up with the latest deprecations on a stable branch, stable branches should turn off the gcc warning for deprecated declarations (e.g. see commit 76a68867).
Be extra-careful not to merge main (or any branch based on main) into a stable branch.
To branch:
git branch dbus-X.Y
and upload the branch tag to the server:
git push origin dbus-X.Y
To develop in this branch:
git checkout dbus-X.Y
After starting a new stable branch:
- update the wiki page https://www.freedesktop.org/wiki/Software/dbus by adding the new release under the Download heading