<div dir="ltr">Package: dh-systemd<div>Version: 1.18</div><div>Severity: minor</div><div><br></div><div>It is conventional to choose command names that express what the command does. Accordingly, it is conventional for debhelper command names to express what they do. For example, the dh_installinit command installs init files into package build directories.</div>

<div><br></div><div>The dh-systemd package departs from this convention and gives its two debhelper scripts names that don't express what THEY do, but what the maintainer scripts that they generate do. The name of the dh_systemd_start script would conventionally be interpreted to suggest that the command starts something. But a debhelper command can do no such thing; it cannot start a service. It can only operate on a package. What it does is prepare the package so that it starts a unit when installed. </div>

<div><br></div><div>According to debhelper conventions it should be called something starting with "dh_installsystemd".</div><div><br></div><div>Whereas this departure from naming conventions is perhaps merely annoying, the man pages are downright misleading. dh_systemd_start(1p) says explicitly "dh_systemd_start is a debhelper program that is responsible for starting/stopping or restarting systemd unit files". </div>

<div><br></div><div>First, it doesn't really make sense to speak of starting or stopping a file. Assuming it's the unit or service that's intended, the quoted statement isn't true. The program does not start a systemd unit, it just prepares other programs so that they will do that if they are run.</div>

<div><br></div><div>Please fix the man page and rename the commands, leaving behind compatibility symlinks.</div><div><br></div><div>Or else please explain how I am mistaken.</div></div>