[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#835520: [PATCH 08/11] Add note about invoke-rc.d normally used via dh



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 431bc47..59cd582 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 usage of invoke-rc.d is normally not done directly
+	      by the maintainer, but rather indirectly via the debhelper
+	      programs that adds the required maintainer-script code
+	      automatically. (See <prgn>dh_installinit</prgn>,
+	      <prgn>dh_systemd_start</prgn>, etc.)
+	    </p>
 	  </sect2>
 	</sect1>
 
-- 
2.10.2


Reply to: