===================================================================
RCS file: /cvs/mandoc/roff.7,v
retrieving revision 1.35
retrieving revision 1.37
diff -u -p -r1.35 -r1.37
--- mandoc/roff.7	2011/11/21 22:19:23	1.35
+++ mandoc/roff.7	2011/12/11 00:38:11	1.37
@@ -1,4 +1,4 @@
-.\"	$Id: roff.7,v 1.35 2011/11/21 22:19:23 kristaps Exp $
+.\"	$Id: roff.7,v 1.37 2011/12/11 00:38:11 schwarze Exp $
 .\"
 .\" Copyright (c) 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
 .\" Copyright (c) 2010, 2011 Ingo Schwarze <schwarze@openbsd.org>
@@ -15,7 +15,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: November 21 2011 $
+.Dd $Mdocdate: December 11 2011 $
 .Dt ROFF 7
 .Os
 .Sh NAME
@@ -844,6 +844,22 @@ only accepts relative paths not containing the strings
 .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.
@@ -952,8 +968,8 @@ Saltzer in 1964.
 Doug McIlroy rewrote it in BCPL in 1969, renaming it
 .Nm .
 Dennis M. Ritchie rewrote McIlroy's
-.Nm 
-in PDP-11 assmebly for
+.Nm
+in PDP-11 assembly for
 .At v1 ,
 Joseph F. Ossanna improved roff and renamed it nroff
 for