Page MenuHomeFreeBSD

ice.4: Avoid first person language
ClosedPublic

Authored by brd on Oct 3 2025, 10:03 PM.
Tags
None
Referenced Files
F152623735: D52896.diff
Thu, Apr 16, 2:14 AM
F152507548: D52896.id163564.diff
Wed, Apr 15, 9:55 AM
Unknown Object (File)
Tue, Apr 14, 1:37 PM
Unknown Object (File)
Tue, Apr 7, 8:18 AM
Unknown Object (File)
Tue, Apr 7, 2:16 AM
Unknown Object (File)
Mon, Apr 6, 4:49 AM
Unknown Object (File)
Mon, Apr 6, 4:31 AM
Unknown Object (File)
Sun, Apr 5, 6:39 AM
Subscribers

Diff Detail

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

Event Timeline

brd requested review of this revision.Oct 3 2025, 10:03 PM
ziaee added inline comments.
share/man/man4/ice.4
43

Better is to avoid prose here at all according to the mdoc maintainer and also the lightning talk I gave at BSDcan. https://youtu.be/RthIOXpwwsM

417–418

I think this should actually be "If the
.Va allow_no_fec_modules_in_auto
sysctl is enabled...".

Sysctls are Va according to style.mdoc, because then you can apropos Va=here.is.the.sysctl.

764
This revision is now accepted and ready to land.Oct 4 2025, 3:06 AM
brd marked 2 inline comments as done.

Address feedback from ziaee

This revision now requires review to proceed.Oct 4 2025, 5:57 PM

@ziaee Thanks for taking the time to review!

share/man/man4/ice.4
43

I am sorry, I am not sure what you mean here? Most driver man pages have this exact text.

brd marked an inline comment as not done.Oct 4 2025, 5:58 PM

Please commit this so I can rewrite the synopsis. Thanks

This revision is now accepted and ready to land.Oct 4 2025, 8:29 PM
This revision was automatically updated to reflect the committed changes.

Done, thanks! Probably should look at all the driver man pages if that is the case.