control: reassign -1 debmake-doc thanks Yah, this is about time to start using new scheme for version dependency.
But as written at the top of each web page of maint-guide: https://www.debian.org/doc/manuals/maint-guide/dreq.en.html#control The rewrite of this tutorial document with updated contents and more practical examples is available as "Guide for Debian Maintainers". Please use this new tutorial as the primary tutorial document. So let me update "Guide for Debian Maintainers (debmake-doc)" instead: https://www.debian.org/doc/manuals/debmake-doc/ch05.en.html#control FYI: HISTORICAL BACKGROUND / FUTURE ACTION PLANS maint-guide was updated by me to address debhelper 9. It was a bit awkward update since I intentionally made this as the minimum change revision just to address debian/rules to use dh syntax. It didn't address library nor add more realistic examples. These became keen issue for addressing M-A. That lead me to rewrite this maint-guide from scratch with ample examples as debmake-doc. Back then dh_make was not adressing new dh9 syntax and it was written in perl. So I made debmake as an alternative. (The current dh_make has been updated and uses python.) I have to admit, I am getting behind on updating packages I offer with newer situation. TODO: * Update debmake-doc to address debhelper 12 in its example * Update debmake to address debhelper 12 in its template * Update debmake to address salsa CI in its template * Update debmake python code structure to use pyproject.toml for itself * no more setup.py * Update debmake code to work with python code using pyproject.toml Once these are done, I think it is time to ask FTP master to remove maint-guide. As I checked debhelper-compat-upgrade-checklist(7), I may need to update more on following concerns: * use of dpkg-maintscript-helper to remove/rename conffiles (available from dpkg 1.15) * /usr/libexec (per FHS 3.0, adopted in Debian Policy 4.1.5). * init-system-helpers (>= 1.54~) * DEB_BUILD_OPTIONS (notest etc.) * conffiles (oops, it seems 12+ needs this) -- need careful * pointer to https://www.debian.org/doc/debian-policy/ap-flowcharts.html Regards, Osamu On Sat, 2024-07-06 at 09:42 +0200, Niels Thykier wrote: > Package: maint-guide > Severity: minor > X-Debbugs-Cc: ni...@thykier.net > > Hi > > I think as of debhelper/12, the recommended way of setting the debhelper > compat level is via the `Build-Depends: debhelper-compat (= X)` in > `debian/control`. With compat level 14 and beyond, debhelper will no > longer use that file at all (replacing it instead with a `X-DH-Compat: > X` field in `debian/control`). > > Therefore, I think section 5.2 should be updated to say that this was a > historical way to define the debhelper compat level and that you may see > them in older packaging. However, it should not be used in newer packages. > > Best regards, > Niels
