It might not be the policys place to define how the maintainer should
automate the packaging work, but atleast mention debhelper to not
fool people into thinking manually writing maintainer scripts is
the preferred method of using invoke-rc.d.
(This is similar to previous commit about update-rc.d but with
invoke-rc.d and also dh_systemd_enable replaced by dh_systemd_start.)
---
policy.sgml | 8 ++++++++
1 file changed, 8 insertions(+)
diff --git a/policy.sgml b/policy.sgml
index d2e39ae..2589fe5 100644
--- a/policy.sgml
+++ b/policy.sgml
@@ -7768,6 +7768,14 @@ test -f <var>program-executed-later-in-script</var> ||
exit 0
<prgn>invoke-rc.d</prgn>, please consult its man page
<manref name="invoke-rc.d" section="8">.
</p>
+
+ <p>
+ Note that the packaging should normally not call invoke-rc.d
+ directly but through debhelper programs that add the required
+ invoke-rc.d calls automatically.
+ (See <prgn>dh_installinit</prgn>,
+ <prgn>dh_systemd_start</prgn>, etc.)
+ </p>
</sect2>
</sect1>
--
2.10.2
