From c62d79fb8ca85c9f9c5296691af9f11c6d4758ea Mon Sep 17 00:00:00 2001
From: Pav Lucistnik <pav@FreeBSD.org>
Date: Wed, 31 Jan 2007 18:43:46 +0000
Subject: [PATCH] - Document @stopdaemon

---
 .../books/porters-handbook/book.sgml            | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/en_US.ISO8859-1/books/porters-handbook/book.sgml b/en_US.ISO8859-1/books/porters-handbook/book.sgml
index 30a7e1363f..cb4b81c869 100644
--- a/en_US.ISO8859-1/books/porters-handbook/book.sgml
+++ b/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>