Page MenuHomeFreeBSD

linux(4): man page tweaks
ClosedPublic

Authored by trasz on Jan 2 2022, 4:21 PM.
Tags
None
Referenced Files
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
Unknown Object (File)
Sep 18 2024, 10:30 PM

Details

Summary

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

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Not Applicable
Unit
Tests Not Applicable

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–35

maybe the Linux ABI at boot time?

56

I think the , isn't needed here

59–78

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?

65

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

82

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

125

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).

82

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

125

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.

82

Sounds good.

debdrup added a subscriber: debdrup.

Looks good to me too.

Some grammar nits.

share/man/man4/linux.4
73

"an alternative version" or "alternative versions"

138
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.