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

[Andreas Henriksson <andreas@fatal.se>]

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 update-rc.d.
---
 policy.sgml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/policy.sgml b/policy.sgml
index af2d1d2..be11109 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 usage of update-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_enable</prgn>, etc.)
+	    </p>
 	  </sect2>
 
 	  <sect2>
-- 
2.10.2