- Document @stopdaemon

svn path=/head/; revision=29475

en_US.ISO8859-1/books/porters-handbook/book.sgml

@@ -7517,6 +7517,23 @@ run_rc_command "$1"</programlisting>
 	substitution using &quot;:=&quot; would inappropriately
 	override the user's intention.</para>
 
+      <sect2>
+	<title>Stopping services at deinstall</title>
+
+	<para>It is possible to have a service stopped automatically as part of
+	  the deinstall routine.  We advise using this feature only when it's
+	  absolutely necessary to stop a service before it's files go
+	  away.  Usually, it's up to the administrator's discretion to decide,
+	  whether to stop the service on deinstall or not.  Also note this
+	  affects upgrades, too.</para>
+
+	<para>Line like this goes to the <filename>pkg-plist</filename>:</para>
+
+	<programlisting>@stopdaemon doormand</programlisting>
+
+	<para>The argument must match the content of
+	  <makevar>USE_RC_SUBR</makevar> variable.</para>
+      </sect2>
     </sect1>
   </chapter>