Date: Tue, 23 May 2023 19:29:49 GMT From: Ed Maste <emaste@FreeBSD.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org Subject: git: b992b27125 - main - porters-handbook: reference tools for handling services Message-ID: <202305231929.34NJTnkJ011801@gitrepo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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 ====
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202305231929.34NJTnkJ011801>