Page MenuHomeFreeBSD

linuxkpi.4, linuxkpi_wlan.4: add short man pages
ClosedPublic

Authored by bz on Jun 11 2025, 7:55 AM.
Tags
None
Referenced Files
F127615655: D50790.id156946.diff
Tue, Sep 2, 8:41 PM
Unknown Object (File)
Wed, Aug 27, 1:21 PM
Unknown Object (File)
Aug 4 2025, 1:30 PM
Unknown Object (File)
Jul 29 2025, 7:50 AM
Unknown Object (File)
Jul 29 2025, 3:01 AM
Unknown Object (File)
Jul 28 2025, 3:46 PM
Unknown Object (File)
Jul 21 2025, 6:24 PM
Unknown Object (File)
Jul 7 2025, 1:43 PM

Details

Summary

Add brief documentation on LinuxKPI.
Add brief documentation on LinuxKPI 802.11 compat so we can refer to
something about which features are supported.

Sponsored by: The FreeBSD Foundation
MFC after: 3 days

Diff Detail

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

Event Timeline

bz requested review of this revision.Jun 11 2025, 7:55 AM
dumbbell added a subscriber: dumbbell.

It doesn’t have an AUTHORS section. You deserve credits for the code and the manpage :-)

I also have one comment inline.

share/man/man4/linuxkpi_wlan.4
83–84

This sentence is unclear to me. Here is how I understand it: the first part tells me that WEP support existed in the past and was dropped, while the second part tells me it never existed but it could be added in the future.

This revision now requires changes to proceed.Jun 11 2025, 8:21 AM

Add AUTHOR section as requested.
Repharase the sentend about WEP and explain why there is no support.

bz marked an inline comment as done.Jun 12 2025, 10:41 PM
share/man/man4/linuxkpi.4
19

Interested in SPDX short form?

36

Kpi is already in the Nd, interested in expanding the acronym to improve the quality of apropos results?

44

Any argument to Fx is treated as the version number, I think. Kernel should probably be joined with the next line.

49
share/man/man4/linuxkpi_wlan.4
62
70

Minor nits, fixable on commit.

share/man/man4/linuxkpi_wlan.4
105
121

For consistency with use of "IF" below

bz marked 8 inline comments as done.

You guys are better than mandoc -T lint :)

Thank you; I hope I got all your suggestions and fixes right + 1 more.

share/man/man4/linuxkpi.4
19

you mean remove the license? Yes. Can do.

This revision is now accepted and ready to land.Jun 13 2025, 6:42 AM
This revision was automatically updated to reflect the committed changes.