Add Debian 13 packaging for g15stats

2026-09-07 16:13:47 +03:00
1 parent 95de11a526
commit 076641c867
@@ -0,0 +1,52 @@
+g15stats for Debian 13 (local fork package)
+=========================================
+
+This packaging targets Linux and debhelper compatibility 13. See PROVENANCE
+for the complete Debian 1.9.2-2 import, licensing and snapshot version choice.
+All upstream modifications are in debian/patches; do not build in the checkout
+when you want it to remain pristine.
+
+Clean source preparation (outside the checkout)
+----------------------------------------------
+Export ONLY tracked upstream files at commit
+95de11a526346b3d9fd33df051b330c36b1c8a16 using git archive, with directory
+prefix g15stats-3.0.3+git20240609.95de11a/. Compress with xz to produce
+g15stats_3.0.3+git20240609.95de11a.orig.tar.xz. Extract in a temporary build
+directory, then copy this debian/ directory into it. Never tar the working
+checkout: .git, quilt state and untracked build outputs must not be included.
+
+In a disposable Debian 13 container, install build-essential, debhelper,
+autoconf, automake, libtool, pkgconf, libgtop2-dev, libg15-dev,
+libg15render-dev and libg15daemon-client-dev (apt-get build-dep on the staged
+source directory also resolves Build-Depends). Install lintian for QA.
+If the already-built local G15 libraries are available, install their runtime
+and development .deb files instead of the distro G15 libraries. Keep libgtop
+and other dependencies from Debian 13. Do not install packages on the host.
+
+Run dpkg-buildpackage -S -us -uc in the staged source directory. In another
+empty directory/container, extract the resulting .dsc with dpkg-source -x,
+then run dpkg-buildpackage -b -us -uc. Source packages here are unsigned;
+dpkg-source --no-check is appropriate only after independently checking the
+locally produced source artifact checksums. Lint both source and binary
+.changes with lintian --fail-on error. Keep logs and all artifacts outside
+the checkout. A second independent extraction/build checks rebuildability;
+bit-for-bit reproducibility is a separate claim requiring comparison.
+
+Safe smoke test
+---------------
+Install the resulting binary in a disposable container with no USB mappings,
+no host networking and no privileged mode. Suppress service startup using
+policy-rc.d before installing g15daemon. Run debian/tests/help, which compares
+timeout-bounded --help and -h output. These exit before any daemon connection,
+sensor access or keyboard thread. Do not invoke the normal client or -d.
+The same test is declared as a superficial autopkgtest.
+
+Scope and limitations
+---------------------
+No service/init, udev rule, keyboard macro or automatic startup is shipped.
+The existing runtime code has not been safety-certified or rewritten: legacy
+sensor paths, argument parsing, array bounds, string handling and threading
+need separate runtime review. Build/CLI tests do not validate hardware, LCD
+rendering, live daemon interaction, battery support or other architectures.
+Use --info-rotate, not the incorrectly documented short form -ir; see the
+manual for the existing parser discrepancy.