From 8044b104253567529bb560a8fa2c0c9319156597 Mon Sep 17 00:00:00 2001
From: Mike Pritchard <mpp@FreeBSD.org>
Date: Thu, 26 Dec 1996 22:34:23 +0000
Subject: [PATCH] Mention that cross references in the SEE ALSO section should
 be sorted by section number and then placed in alphabetical order.

---
 share/man/man7/mdoc.samples.7 | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/share/man/man7/mdoc.samples.7 b/share/man/man7/mdoc.samples.7
index 38b40dfb127b..7b42c80486b7 100644
--- a/share/man/man7/mdoc.samples.7
+++ b/share/man/man7/mdoc.samples.7
@@ -1975,6 +1975,16 @@ Cross references
 are specified using the
 .Ql \&.Xr
 macro.
+Cross references in the
+.Sx SEE ALSO
+section should be sorted by section number, and then
+placed in alphabetical order and comma separated.  For example:
+.Pp
+.Xr ls 1 ,
+.Xr ps 1 ,
+.Xr group 5 ,
+.Xr passwd 5 .
+.Pp
 At this time
 .Xr refer 1
 style references are not accommodated.
@@ -2775,9 +2785,9 @@ manual macro package
 template for writing a man page
 .El
 .Sh SEE ALSO
-.Xr mdoc 7 ,
 .Xr man 1 ,
-.Xr troff 1
+.Xr troff 1 ,
+.Xr mdoc 7
 .Sh BUGS
 Undesirable hyphenation on the dash of a flag
 argument is not yet resolved, and causes