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

[Andreas Henriksson <andreas@fatal.se>]

It might not be the policy's place to define how the maintainer should
automate the packaging work, but at least mention debhelper to not
fool people into thinking manually writing maintainer scripts is
the preferred method of using update-rc.d.
---
 policy.sgml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/policy.sgml b/policy.sgml
index d1108be..37cac8a 100644
--- a/policy.sgml
+++ b/policy.sgml
@@ -7712,6 +7712,14 @@ test -f <var>program-executed-later-in-script</var> || exit 0
 	      please consult its man page <manref name="update-rc.d"
 		section="8">.
 	    </p>
+
+	    <p>
+	      Note that the packaging should normally not call update-rc.d
+	      directly but through debhelper programs that add the required
+	      update-rc.d calls automatically.
+	      (See <prgn>dh_installinit</prgn>,
+	      <prgn>dh_systemd_enable</prgn>, etc.)
+	    </p>
 	  </sect2>
 
 	  <sect2>
-- 
2.10.2