Page MenuHomeFreeBSD

ibnd_*(3): fix source of manpage
ClosedPublic

Authored by fernape on Feb 17 2021, 2:25 PM.

Details

Summary

Some ibnd_* manpages source other manpages from a man3/ directory when it should
reference the pages in the current directory.

PR: 237693
Reported by: wosch@FreeBSD.org

Test Plan
$ man ibnd_debug

This is what you get:

()                                                                          ()




See the file ibnd_discover_fabric.3.




                               February 17, 2021                            ()
(END)

This was tested in 12.2-RELEASE and 13-stable

After aplying the patch

$ cd lib/ofed/libibnetdisc && make
$ man ./ibnd_debug.3.gz

It shows expected results.

Diff Detail

Repository
R10 FreeBSD src repository
Lint
Automatic diff as part of commit; lint not applicable.
Unit
Automatic diff as part of commit; unit tests not applicable.

Event Timeline

I'd rather not modify the contrib source, skip installing these, and use MLINKS instead.

Address comments by yuripv@

  • Do not install affected pages
  • Use MLINKS instead of fixing the .so macro (discouraged by mandoc(1))

Test plan:

Apply the patch and then:

$ cd lib/ofed/libibnetdisc && make install
...
...
$ man ibnd_debug
$ man ibnd_destroy_fabric
$ man ibnd_iter_nodes_type
$ man ibnd_find_node_dr
$ man ibnd_show_progress
This revision is now accepted and ready to land.Feb 17 2021, 3:10 PM
This revision was automatically updated to reflect the committed changes.