mdocml: Explain where .so paths are rooted, and why, and discourage its

mdocml: Explain where .so paths are rooted, and why, and discourage its

[schwarze]

Log Message:
-----------
Explain where .so paths are rooted, and why, and discourage its use;
feedback and ok jmc@, suggested by and ok kristaps@.

Modified Files:
--------------
    mdocml:
        roff.7

Revision Data
-------------
Index: roff.7
===================================================================
RCS file: /usr/vhosts/mdocml.bsd.lv/cvs/mdocml/roff.7,v
retrieving revision 1.36
retrieving revision 1.37
diff -Lroff.7 -Lroff.7 -u -p -r1.36 -r1.37
--- roff.7
+++ roff.7
@@ -844,6 +844,22 @@ only accepts relative paths not containi
 .Qq ../
 and
 .Qq /.. .
+.Pp
+This request requires
+.Xr man 1
+to change to the right directory before calling
+.Xr mandoc 1 ,
+per convention to the root of the manual tree.
+Typical usage looks like:
+.Pp
+.Dl \&.so man3/Xcursor.3
+.Pp
+As the whole concept is rather fragile, the use of
+.Sx \&so
+is discouraged.
+Use
+.Xr ln 1
+instead.
 .Ss \&ta
 Set tab stops.
 This line-scoped request can take an arbitrary number of arguments.
--
 To unsubscribe send an email to source+unsubscribe@mdocml.bsd.lv