Page MenuHomeFreeBSD

linux(4): man page tweaks
ClosedPublic

Authored by trasz on Jan 2 2022, 4:21 PM.
Tags
None
Referenced Files
F106164122: D33720.id100844.diff
Thu, Dec 26, 10:57 AM
F106133551: D33720.diff
Wed, Dec 25, 11:09 PM
Unknown Object (File)
Wed, Dec 11, 6:30 PM
Unknown Object (File)
Tue, Dec 10, 7:25 PM
Unknown Object (File)
Nov 8 2024, 11:03 AM
Unknown Object (File)
Nov 8 2024, 6:58 AM
Unknown Object (File)
Sep 25 2024, 3:48 AM
Unknown Object (File)
Sep 21 2024, 7:02 AM

Details

Summary

Advertise rc.conf method as the right way to enable it, mention
file system mapping... and change some wording.

Diff Detail

Repository
rS FreeBSD src repository - subversion
Lint
Lint Passed
Unit
No Test Coverage
Build Status
Buildable 43677
Build 40565: arc lint + arc unit

Event Timeline

trasz requested review of this revision.Jan 2 2022, 4:21 PM

A couple of little comments, overall looks good thanks for updating this!

share/man/man4/linux.4
34

maybe the Linux ABI at boot time?

56

I think the , isn't needed here

62

I might get rid of try to. Whether or not the translated path was found, they do perform the look up. Or "try to access file paths" or "try to reference file paths" or some such?

68

comma splice - make it a ., and start a new sentence with the next part.

Can expand e.g. to For example, when Linux... to make it a reasonable start to the sentence

85

We have some other linux packages in the works too, right?

128

We should perhaps leave a note in the source with a reference back to this man page, such that if someone ever changed it they would find a hint to update here too.

trasz marked 2 inline comments as done.Jan 2 2022, 9:24 PM
trasz added inline comments.
share/man/man4/linux.4
56

How about just removing this part altogether? It's redundant, might be confusing (because there are more than those two involved), and isn't even technically true (because those two are separate kernel modules).

85

We do, we should document https://reviews.freebsd.org/D33652, also debootstrap. But let's do that in a separate commit.

128

I don't think this will ever change, this looks more like a magic number. One that will change is the kernel version, and that's why I've left it undocumented for now.

emaste added inline comments.
share/man/man4/linux.4
56

Oh, I think the filesystems themselves were fine to list just the comma wasn't necessary.

This revision is now accepted and ready to land.Jan 2 2022, 9:25 PM
share/man/man4/linux.4
56

Oh I replied after seeing your update but before seeing your comments. I think that's fine too.

85

Sounds good.

debdrup added a subscriber: debdrup.

Looks good to me too.

Some grammar nits.

share/man/man4/linux.4
76

"an alternative version" or "alternative versions"

141
This revision now requires review to proceed.Jan 4 2022, 1:10 PM
This revision was not accepted when it landed; it landed in state Needs Review.Jan 5 2022, 8:18 AM
This revision was automatically updated to reflect the committed changes.