IfAPI: Update ifnet(9) man page

[jhibbits]

Summary

Extremely rough start of documenting the IfAPI.

Posting to solicit feedback on if this is the right way to do it, my man-fu
is... bad at best.

[emaste]

share/man/man9/Makefile

1344

I wonder if we should mlink it or have a standalone ifapi(9) (as we do with iflib)? Not sure, but if we do decide to do so it could be a subsequent change.

share/man/man9/ifnet.9

104

blank lines are discouraged in man pages I believe, use .\" if spacing is desired for readability

[concussious.bugzilla_runbox.com]

This is cool! Just a few tiny nits from me. emaste is correct about the empty space, it actually produces two linter errors.

share/man/man9/ifnet.9

29

You wanna spell out the whole month in mdoc(7) or it produces a linter error. You can check the linter for errors with mandoc -Tlint share/man/man9/ifnet.9.

426–428

Not sure if this is correct, but there are a striking amount of parenthesis here, making it hard to understand.

438–439

444–446

Again, not sure that this meaning is correct, you may need to use a different word than "attaching" but lots of parenthesis is stressful for English.

449–456

Although, style.mdoc(5) says Dq Li is deprecated and suggests using Ql instead. Note that this renders as single quoted instead of double quoted.

469

482

You may need to use different word than "attaching", I do not understand the code, but full sentences inside parenthesis, particularly with punctuation, is kinda... a grammatical structure of last resort in American English.

496

521–522

531–532

536–537

542–544

548

550

561

[jhibbits]

Address feedback. Also ran mandoc -T lint over it, and fixed existing lint errors.

[jhibbits]

Update date.

[jhibbits]

In D47931#1092874, @concussious.bugzilla_runbox.com wrote:

This is cool! Just a few tiny nits from me. emaste is correct about the empty space, it actually produces two linter errors.

Thanks for the review. Some of the nits you pointed out were preexisting, where I simply moved the text around, but I'm glad you pointed the issues out, so I can correct them to better fit with the function APIs rather than the preexisting structure.

I think I've fixed everything you pointed out.

[jhibbits]

Actually update the date...