#1151007 zram-tools: manual page installed in section 1, but zramswap.service refers to zramswap(8)

#1151007#5
Date:
2026-10-15 16:07:47 UTC
From:
To:
Dear Maintainer,

zramswap.service has Documentation=man:zramswap(8), and the manual page
source is called zramswap.8, but its .TH line puts the page in
section 1. dh_installman takes the section from .TH, so the page is
installed as /usr/share/man/man1/zramswap.1.gz and the reference in the
unit does not resolve:

  $ man -w 8 zramswap
  No manual entry for zramswap in section 8
  $ man -w zramswap
  /usr/share/man/man1/zramswap.1.gz
  $ systemctl help zramswap.service
  No manual entry for zramswap in section 8

The package file lists on packages.debian.org show the same man1 path
for 0.3.7-1 in trixie and sid, and the .TH line is unchanged on master
in salsa.

zramswap is installed in /usr/sbin, so section 8 looks right. This
changes the .TH line, and no packaging change is needed:
--- a/zramswap.8
+++ b/zramswap.8
@@ -1,4 +1,4 @@
-.TH "zramswap" 1 "2018-10-04" "zramswap"
+.TH "zramswap" 8 "2018-10-04" "zramswap"
 .SH NAME
 zramswap \- configure swap on zram
 .SH SYNOPSIS

With it applied, groff -man -ww reports no warnings, man -l shows
zramswap(8), and man -w 8 zramswap finds the page.

I ran into this on Linux Mint 22.3, which installs zram-tools
0.3.3.1-1.1 from Ubuntu 24.04 (noble), unchanged from Debian.

Thanks,
Azan