From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from krisdoz.my.domain (schwarze@localhost [127.0.0.1])
	by krisdoz.my.domain (8.14.5/8.14.5) with ESMTP id pBB0cBB2032685
	for <source@mdocml.bsd.lv>; Sat, 10 Dec 2011 19:38:11 -0500 (EST)
Received: (from schwarze@localhost)
	by krisdoz.my.domain (8.14.5/8.14.3/Submit) id pBB0cB5p022256;
	Sat, 10 Dec 2011 19:38:11 -0500 (EST)
Date: Sat, 10 Dec 2011 19:38:11 -0500 (EST)
Message-Id: <201112110038.pBB0cB5p022256@krisdoz.my.domain>
X-Mailinglist: mdocml-source
Reply-To: source@mdocml.bsd.lv
MIME-Version: 1.0
From: schwarze@mdocml.bsd.lv
To: source@mdocml.bsd.lv
Subject: mdocml: Explain where .so paths are rooted, and why, and discourage its 
X-Mailer: activitymail 1.26, http://search.cpan.org/dist/activitymail/
Content-Type: text/plain; charset=utf-8

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