cr_bsd_visible(9): New man page

[bcr]

Thanks for writing the man page. Run
mandoc -Tlint
and
textproc/igor
on it to see any extra warnings and get help fixing them.

share/man/man9/cr_bsd_visibility.9

47 ↗

(On Diff #123498)

You need to make a line break after a sentence stop.

51 ↗

(On Diff #123498)

Another line break needed here.

55 ↗

(On Diff #123498)

and here...

[olce.freebsd_certner.fr]

Change the one-line description. New sentences on new lines.

[olce.freebsd_certner.fr]

In D40632#928644, @bcr wrote:

Thanks for writing the man page. Run
mandoc -Tlint
and
textproc/igor
on it to see any extra warnings and get help fixing them.

Thanks, I wasn't aware of these tools (I had already installed docproj, but not looked at dependencies).

I've fixed all warnings except that about the order of references in SEE ALSO. I'm now aware that there is a traditional order for these (as documented in mdoc(7)). However, if tolerable, I would prefer to keep mine since I laid out the references precisely so they follow the order of appearance in the text (and the return values), with an extra reference (the least important) at the end.

[pauamma_gundo.com]

English LGTM.

[olce.freebsd_certner.fr]

Forgot to have the file installed.

[olce.freebsd_certner.fr]

Rename cr_bsd_visibility() to cr_bsd_visible().

[olce.freebsd_certner.fr]

And also addressed similar issues as reported in https://reviews.freebsd.org/D40639.

[olce.freebsd_certner.fr]

Fix a grammar error (pointed out by Pau Amma via D40644).

[olce.freebsd_certner.fr]

'cr_see*' => 'cr_cansee*' (suppressed a rename in the stack).