When mentioning a function documented elsewhere, .Xr is often better than .Fn.

Prodded by guenther@, ok jmc@.

1 files changed, 3 insertions, 0 deletions

diff --git a/mdoc.7 b/mdoc.7
index 9e4fe6ce..9abd7e94 100644
--- a/mdoc.7
+++ b/mdoc.7
@@ -1871,6 +1871,9 @@ Examples:
 \&.Fn funcname
 .Ed
 .Pp
+When referring to a function documented in another manual page,
+.Sx \&Xr
+is usually preferable.
 See also
 .Sx MANUAL STRUCTURE
 and