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" substitution using ":=" would inappropriately override the user's intention. + + Stopping services at deinstall + + 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. + + Line like this goes to the pkg-plist: + + @stopdaemon doormand + + The argument must match the content of + USE_RC_SUBR variable. +