git: b992b27125 - main - porters-handbook: reference tools for handling services

The branch main has been updated by emaste:

URL: https://cgit.FreeBSD.org/doc/commit/?id=b992b27125b598a582108cb4550fcd39acbe5334

commit b992b27125b598a582108cb4550fcd39acbe5334
Author:     Sven Ruediger <freebsd@hackacad.net>
AuthorDate: 2023-05-23 16:22:40 +0000
Commit:     Ed Maste <emaste@FreeBSD.org>
CommitDate: 2023-05-23 19:28:20 +0000

    porters-handbook: reference tools for handling services
    
    Mention that `service name start` and `sysrc name_enable=YES` should be
    used in pkg messages, rather than invoking the rc script directly or
    editing /etc/rc.conf.
    
    Reviewed by:    bcr (earlier), jrm, emaste
    Event:          Kitchener-Waterloo Hackathon 202305
    Differential Revision: https://reviews.freebsd.org/D40217
---
 .../content/de/books/porters-handbook/pkg-files/_index.adoc       | 8 ++++++++
 .../content/en/books/porters-handbook/pkg-files/_index.adoc       | 3 +++
 2 files changed, 11 insertions(+)

diff --git a/documentation/content/de/books/porters-handbook/pkg-files/_index.adoc b/documentation/content/de/books/porters-handbook/pkg-files/_index.adoc
index e5ec5b10af..8ba50d28c3 100644
--- a/documentation/content/de/books/porters-handbook/pkg-files/_index.adoc
+++ b/documentation/content/de/books/porters-handbook/pkg-files/_index.adoc
@@ -64,6 +64,14 @@ update-etc-shells:
     @${RM} /etc/shells.bak
 ....
 
+[NOTE]
+====
+Stellen Sie sicher, dass sie auf die korrekten Tools zum Verwalten von Diensten verweisen.
+* Verwenden Sie `service name start`, um einen Dienst zu starten, anstatt `/usr/local/etc/rc.d/name start` zu verwenden.
+* Verwenden Sie `sysrc name_enable=YES`, um Optionen in rc.conf zu ändern.
+
+====
+
 [NOTE]
 ====
 Die [.filename]#pkg-message# wird nicht zur [.filename]#pkg-plist# hinzugefügt. Sie wird auch nicht automatisch angezeigt, falls ein Anwender den Port installiert. Sie müssen also die Ausgabe selbst im `post-install`-Ziel des Make-Vorgangs veranlassen.
diff --git a/documentation/content/en/books/porters-handbook/pkg-files/_index.adoc b/documentation/content/en/books/porters-handbook/pkg-files/_index.adoc
index 413637c4af..a595c94ba2 100644
--- a/documentation/content/en/books/porters-handbook/pkg-files/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/pkg-files/_index.adoc
@@ -61,6 +61,9 @@ This capability is often useful to display additional installation steps to be t
 * Setup information should only be shown on initial install. Upgrade instructions should be shown only when upgrading from the relevant version.
 * Do not surround the messages with either whitespace or lines of symbols (like `----------`, `**********`, or `==========`). Leave the formatting to man:pkg[8].
 * Committers have blanket approval to constrain existing messages to install or upgrade ranges using the UCL format specifications.
+* Please be sure to refer to the proper tools for handling services.
+** Use `service name start` to start a service rather than using `/usr/local/etc/rc.d/name start`
+** Use `sysrc name_enable=YES` to change options in rc.conf
 
 ====