man: Discourage using the library in non-overlay mode

This makes code using it non-portable, and requires the namespeced
headers from libbsd, instead of any generic system headers. It also
requires more code changes than the overlay mode.

diff --git a/man/libbsd.7 b/man/libbsd.7
index 638caf8268a898dced05d6358c53068a4b551e4c..676e1300dfa1ee4caad23cb56f8b4b535ea46580 100644 (file)
--- a/man/libbsd.7
+++ b/man/libbsd.7
@@ -59,7 +59,7 @@ The includes in this case should be the usual system ones, such as
 .In unistd.h .
 .Pp
 The other way to use the library is to use the namespaced headers,
-this is less portable as it makes using
+which is a discouraged way, being less portable as it makes using
 .Nm libbsd
 mandatory and it will not work on BSD-based systems, and requires
 modifying original BSD code.