Page MenuHomeFreeBSD

Add the Arm CoreLink CMN-600 Coherent Mesh Network Controller PMU driver man page.
ClosedPublic

Authored by tsoome on Oct 6 2021, 9:28 AM.
Tags
None
Referenced Files
F102394391: D32335.id96336.diff
Mon, Nov 11, 4:20 PM
Unknown Object (File)
Sat, Nov 9, 5:33 PM
Unknown Object (File)
Thu, Oct 31, 1:37 AM
Unknown Object (File)
Thu, Oct 24, 9:50 AM
Unknown Object (File)
Sun, Oct 20, 10:59 AM
Unknown Object (File)
Oct 4 2024, 5:41 AM
Unknown Object (File)
Oct 3 2024, 6:21 AM
Unknown Object (File)
Oct 3 2024, 4:51 AM

Details

Summary

Add the Arm CoreLink CMN-600 Coherent Mesh Network Controller PMU driver man page.

Sponsored By: ARM

Diff Detail

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

Event Timeline

ray requested review of this revision.Oct 6 2021, 9:28 AM
ray added reviewers: pmc, mhorne.

Could you ran 'mandoc -Tlint' over the man page. There are plenty of warnings, which could easily be fixed, like 'new sentence, new line' and so on. It would be nice if you could also add the author of the man page.

And you have to include this man page in the makefile of the directory.

Fix formating according to mandoc lint hints.

In D32335#747099, @gbe wrote:

Could you ran 'mandoc -Tlint' over the man page. There are plenty of warnings, which could easily be fixed, like 'new sentence, new line' and so on. It would be nice if you could also add the author of the man page.

And you have to include this man page in the makefile of the directory.

Done. Thanks for review, Gordon!

Most of the content is beyond me, but still have a few suggestions.

lib/libpmc/pmc.cmn-600.3
42

The capitalisation of "Id" here looks odd to me, but it may just be me. (In case it's not, I'd use either "ID" or "identifier".)

44–54

Worth using Bl/El/It here for clarity?

176

Spurious space after "-"?

Also, does the intended audience for this know what "protocol-retried" means?

272
596

Maybe include the manual page author as well, as shown in the vt(4) example in https://docs.freebsd.org/en/books/fdp-primer/manual-pages/#manual-pages-examples-as-templates ?

tsoome added a reviewer: ray.
tsoome marked 4 inline comments as done.

and more feedback

English LGTM. Can't speak to accuracy.

This revision is now accepted and ready to land.Jul 9 2022, 7:10 PM