Page MenuHomeFreeBSD

Update handbook/pkg-files#pkg-message to use sysrc and service
ClosedPublic

Authored by emaste on May 22 2023, 9:27 PM.
Tags
None
Referenced Files
Unknown Object (File)
Sun, Nov 24, 1:39 AM
Unknown Object (File)
Wed, Nov 20, 3:01 PM
Unknown Object (File)
Wed, Nov 20, 3:01 PM
Unknown Object (File)
Mon, Nov 18, 3:08 AM
Unknown Object (File)
Oct 10 2024, 3:40 AM
Unknown Object (File)
Oct 1 2024, 9:47 PM
Unknown Object (File)
Sep 30 2024, 9:34 PM
Unknown Object (File)
Sep 28 2024, 2:46 PM
Subscribers

Details

Summary

Certain services still refer to /usr/local/etc/rc.d/name start and edit /etc/rc.conf instead of using sysrc and service.
Updated handbook in preparation for patching affected ports

Diff Detail

Repository
R9 FreeBSD doc repository
Lint
Lint Skipped
Unit
Tests Skipped

Event Timeline

admin_hackacad.net created this revision.
bcr added a subscriber: bcr.

Looks good, both the German and English versions. Much appreciated!

This revision is now accepted and ready to land.May 23 2023, 7:51 AM
documentation/content/en/books/porters-handbook/pkg-files/_index.adoc
69

I think we avoid (or at least, have avoided) "you" in our documentation. So e.g. "Please be sure to refer..."

I've asked in the #bsddocs channel and am looking for a canonical reference.

documentation/content/en/books/porters-handbook/pkg-files/_index.adoc
69

Ah yes, https://docs.freebsd.org/en/books/fdp-primer/writing-style/

Write in a formal style. Avoid addressing the reader as "you". For example, say "copy the file to /tmp" rather than "you can copy the file to /tmp".

This revision now requires review to proceed.May 23 2023, 4:11 PM
jrm added a subscriber: jrm.

Looks good to me, but would it be cleaner to just add the two lines below to the list in the [IMPORTANT] section above rather than having two consecutive colour blocks?

This revision is now accepted and ready to land.May 23 2023, 6:12 PM

I think @jrm is right, this can just go in the existing box:

image.png (382×1 px, 69 KB)

The German version has a number of separate NOTEs though, so I will leave that as is.

emaste updated this revision to Diff 122331.
emaste edited reviewers, added: admin_hackacad.net; removed: emaste.

Combine new note into existing block

This revision now requires review to proceed.May 23 2023, 6:42 PM
This revision is now accepted and ready to land.May 23 2023, 7:03 PM

Oops @carlavilla just missed your review before pushing.