Index: ./share/man/man5/bsd.port.mk.5
===================================================================
RCS file: /home/cvs/src/share/man/man5/bsd.port.mk.5,v
retrieving revision 1.550
diff -u -p -u -p -r1.550 bsd.port.mk.5
--- ./share/man/man5/bsd.port.mk.5	22 Nov 2021 11:17:39 -0000	1.550
+++ ./share/man/man5/bsd.port.mk.5	12 Dec 2021 12:42:20 -0000
@@ -3558,17 +3558,27 @@ usage.
 .It LIB_DEPENDS <spec> not needed for <FULLPKGPATH>
 There doesn't seem to be any WANTLIB to match the given LIB_DEPENDS.
 Thus, the LIB_DEPENDS won't turn into a @depends line in the created package.
-This is often because of confusion between LIB_DEPENDS and RUN_DEPENDS:
-RUN_DEPENDS is needed for dlopen'd libraries.
+This is often because of confusion between LIB_DEPENDS and RUN_DEPENDS.
 .Pp
-Might be intentional sometimes, if some compile flavors create static binaries,
-for instance.
-Also, will happen for multi-packages, where one sets LIB_DEPENDS to have
+This can be intentional when libraries are needed, but can not be
+found dynamically linked:
+.Pp
+Libraries loaded by
+.Xr dlopen 3
+should be added to WANTLIB and LIB_DEPENDS to ensure a rebuild when the
+library is updated.
+.Pp
+Some compile flavors create static binaries, but should be rebuild when
+the library changes.
+.Pp
+It will happen for multi-packages, where one sets LIB_DEPENDS to have
 a given build dependency (and corresponding WANTLIB for a given SUBPACKAGE).
 .Pp
 See
 .Cm print-package-args Pq Cm lib-depends-args
 for details.
+.Pp
+In such cases, add a comment to the Makefile about the intentional warning.
 .It "Warning: FULLPKGNAME-sub defined but not FULLPKGPATH-sub"
 .Ev FULLPKGNAME-sub
 has been explicitly defined by the port, instead of relying on the default,