git: 6e1fc0118033 - main - manuals: Fix "unusual .Xr" warnings with a script

From: Mitchell Horne <mhorne_at_FreeBSD.org>
Date: Tue, 15 Oct 2024 20:21:27 UTC
The branch main has been updated by mhorne:

URL: https://cgit.FreeBSD.org/src/commit/?id=6e1fc0118033f42b7c0d3623c8f67a89ebecabb2

commit 6e1fc0118033f42b7c0d3623c8f67a89ebecabb2
Author:     Graham Percival <gperciva@tarsnap.com>
AuthorDate: 2024-10-15 15:44:42 +0000
Commit:     Mitchell Horne <mhorne@FreeBSD.org>
CommitDate: 2024-10-15 20:18:14 +0000

    manuals: Fix "unusual .Xr" warnings with a script
    
    These were reported by `mandoc -T lint ...` as warnings:
    - unusual Xr order
    - unusual Xr punctuation
    
    Fixes made by script in https://github.com/Tarsnap/freebsd-doc-scripts
    
    Signed-off-by:  Graham Percival <gperciva@tarsnap.com>
    Reviewed by:    mhorne, Alexander Ziaee <concussious.bugzilla@runbox.com>
    Sponsored by:   Tarsnap Backup Inc.
    Pull Request:   https://github.com/freebsd/freebsd-src/pull/1464
---
 bin/rmdir/rmdir.1                                | 2 +-
 lib/libc/gen/posix_spawn.3                       | 4 ++--
 lib/libc/gen/setproctitle.3                      | 4 ++--
 lib/libc/stdlib/memory.3                         | 2 +-
 lib/libc/string/bstring.3                        | 1 -
 lib/libjail/jail.3                               | 2 +-
 lib/libpam/modules/pam_chroot/pam_chroot.8       | 4 ++--
 lib/libpam/modules/pam_deny/pam_deny.8           | 4 ++--
 lib/libpam/modules/pam_echo/pam_echo.8           | 4 ++--
 lib/libpam/modules/pam_exec/pam_exec.8           | 6 +++---
 lib/libpam/modules/pam_ftpusers/pam_ftpusers.8   | 4 ++--
 lib/libpam/modules/pam_group/pam_group.8         | 4 ++--
 lib/libpam/modules/pam_guest/pam_guest.8         | 4 ++--
 lib/libpam/modules/pam_krb5/pam_krb5.8           | 4 ++--
 lib/libpam/modules/pam_ksu/pam_ksu.8             | 4 ++--
 lib/libpam/modules/pam_lastlog/pam_lastlog.8     | 4 ++--
 lib/libpam/modules/pam_nologin/pam_nologin.8     | 4 ++--
 lib/libpam/modules/pam_passwdqc/pam_passwdqc.8   | 4 ++--
 lib/libpam/modules/pam_permit/pam_permit.8       | 4 ++--
 lib/libpam/modules/pam_radius/pam_radius.8       | 4 ++--
 lib/libpam/modules/pam_rhosts/pam_rhosts.8       | 4 ++--
 lib/libpam/modules/pam_rootok/pam_rootok.8       | 4 ++--
 lib/libpam/modules/pam_securetty/pam_securetty.8 | 4 ++--
 lib/libpam/modules/pam_self/pam_self.8           | 4 ++--
 lib/libpam/modules/pam_ssh/pam_ssh.8             | 4 ++--
 lib/libpam/modules/pam_unix/pam_unix.8           | 2 +-
 lib/libsys/fhreadlink.2                          | 2 +-
 lib/libsys/getrlimitusage.2                      | 2 +-
 lib/libsys/socket.2                              | 6 +++---
 lib/libsys/thr_kill.2                            | 2 +-
 lib/libsys/x86/pkru.3                            | 2 +-
 lib/libsysdecode/sysdecode_sctp_sinfo_flags.3    | 2 +-
 lib/libthr/libthr.3                              | 4 ++--
 lib/libveriexec/veriexec.3                       | 2 +-
 sbin/comcontrol/comcontrol.8                     | 2 +-
 sbin/newfs/newfs.8                               | 2 +-
 sbin/umount/umount.8                             | 4 ++--
 share/man/man4/atopcase.4                        | 4 ++--
 share/man/man4/cd.4                              | 2 +-
 share/man/man4/cdce.4                            | 4 ++--
 share/man/man4/dummynet.4                        | 4 ++--
 share/man/man4/ftgpio.4                          | 2 +-
 share/man/man4/ipfirewall.4                      | 2 +-
 share/man/man4/ipsec.4                           | 2 +-
 share/man/man4/lindebugfs.4                      | 4 ++--
 share/man/man4/mac_do.4                          | 4 ++--
 share/man/man4/man4.aarch64/rk_gpio.4            | 2 +-
 share/man/man4/man4.aarch64/rk_i2c.4             | 2 +-
 share/man/man4/man4.aarch64/rk_pinctrl.4         | 2 +-
 share/man/man4/man4.arm/imx6_ahci.4              | 2 +-
 share/man/man4/mpi3mr.4                          | 2 +-
 share/man/man4/netmap.4                          | 4 ++--
 share/man/man4/ng_nat.4                          | 4 ++--
 share/man/man4/ng_pppoe.4                        | 4 ++--
 share/man/man4/procdesc.4                        | 2 +-
 share/man/man4/virtio_gpu.4                      | 2 +-
 share/man/man5/pf.conf.5                         | 2 +-
 share/man/man8/rc.subr.8                         | 2 +-
 share/man/man8/uefi.8                            | 2 +-
 share/man/man9/VOP_SETLABEL.9                    | 8 ++++----
 share/man/man9/cr_bsd_visible.9                  | 8 ++++----
 share/man/man9/cr_cansee.9                       | 6 +++---
 share/man/man9/cr_canseeothergids.9              | 4 ++--
 share/man/man9/groupmember.9                     | 2 +-
 share/man/man9/p_candebug.9                      | 8 ++++----
 share/man/man9/p_cansee.9                        | 4 ++--
 share/man/man9/rtentry.9                         | 2 +-
 tools/tools/ether_reflect/ether_reflect.1        | 2 +-
 usr.bin/beep/beep.1                              | 2 +-
 usr.bin/gzip/gzip.1                              | 2 +-
 usr.bin/mdo/mdo.1                                | 2 +-
 usr.bin/msgs/msgs.1                              | 2 +-
 usr.bin/posixmqcontrol/posixmqcontrol.1          | 2 +-
 usr.sbin/efibootmgr/efibootmgr.8                 | 2 +-
 usr.sbin/i2c/i2c.8                               | 2 +-
 usr.sbin/jail/jail.8                             | 2 +-
 usr.sbin/lastlogin/lastlogin.8                   | 4 ++--
 usr.sbin/mailwrapper/mailwrapper.8               | 2 +-
 usr.sbin/rpc.tlsclntd/rpc.tlsclntd.8             | 2 +-
 79 files changed, 126 insertions(+), 127 deletions(-)

diff --git a/bin/rmdir/rmdir.1 b/bin/rmdir/rmdir.1
index eb23c605050c..b43328110960 100644
--- a/bin/rmdir/rmdir.1
+++ b/bin/rmdir/rmdir.1
@@ -96,7 +96,7 @@ stopping at the first non-empty directory (if any):
 .Pp
 .Dl $ rmdir -p cow/horse/monkey
 .Sh SEE ALSO
-.Xr rm 1
+.Xr rm 1 ,
 .Xr rmdir 2
 .Sh STANDARDS
 The
diff --git a/lib/libc/gen/posix_spawn.3 b/lib/libc/gen/posix_spawn.3
index 55559ae7222b..278fee88463a 100644
--- a/lib/libc/gen/posix_spawn.3
+++ b/lib/libc/gen/posix_spawn.3
@@ -446,12 +446,12 @@ action.
 .Xr sched_setscheduler 2 ,
 .Xr setpgid 2 ,
 .Xr vfork 2 ,
+.Xr posix_spawn_file_actions_addchdir_np 3 ,
 .Xr posix_spawn_file_actions_addclose 3 ,
 .Xr posix_spawn_file_actions_addclosefrom_np 3 ,
 .Xr posix_spawn_file_actions_adddup2 3 ,
-.Xr posix_spawn_file_actions_addopen 3 ,
-.Xr posix_spawn_file_actions_addchdir_np 3 ,
 .Xr posix_spawn_file_actions_addfchdir_np 3 ,
+.Xr posix_spawn_file_actions_addopen 3 ,
 .Xr posix_spawn_file_actions_destroy 3 ,
 .Xr posix_spawn_file_actions_init 3 ,
 .Xr posix_spawnattr_destroy 3 ,
diff --git a/lib/libc/gen/setproctitle.3 b/lib/libc/gen/setproctitle.3
index 15bafa23a982..087cbe4b84e9 100644
--- a/lib/libc/gen/setproctitle.3
+++ b/lib/libc/gen/setproctitle.3
@@ -74,10 +74,10 @@ setproctitle("talking to %s", inet_ntoa(addr));
 .Sh SEE ALSO
 .Xr ps 1 ,
 .Xr w 1 ,
-.Xr setprogname 3 ,
 .Xr kvm 3 ,
 .Xr kvm_getargv 3 ,
-.Xr printf 3
+.Xr printf 3 ,
+.Xr setprogname 3
 .Sh STANDARDS
 The
 .Fn setproctitle
diff --git a/lib/libc/stdlib/memory.3 b/lib/libc/stdlib/memory.3
index 3e0d2bf8e304..b7703cf44bd5 100644
--- a/lib/libc/stdlib/memory.3
+++ b/lib/libc/stdlib/memory.3
@@ -83,7 +83,7 @@ individual manual pages.
 .Xr posix_memalign 3 ,
 .Xr realloc 3 ,
 .Xr reallocf 3 ,
-.Xr valloc 3 ,
+.Xr valloc 3
 .Sh STANDARDS
 The
 .Fn calloc ,
diff --git a/lib/libc/string/bstring.3 b/lib/libc/string/bstring.3
index 91603fe6dbac..dd89af44fc4a 100644
--- a/lib/libc/string/bstring.3
+++ b/lib/libc/string/bstring.3
@@ -83,7 +83,6 @@ See the specific manual pages for more information.
 .Xr memccpy 3 ,
 .Xr memchr 3 ,
 .Xr memcmp 3 ,
-.Xr memccpy 3 ,
 .Xr memcpy 3 ,
 .Xr memmove 3 ,
 .Xr memset 3
diff --git a/lib/libjail/jail.3 b/lib/libjail/jail.3
index 3c3c24d75dc4..820e378eb625 100644
--- a/lib/libjail/jail.3
+++ b/lib/libjail/jail.3
@@ -270,8 +270,8 @@ A parameter is of an unknown type.
 .El
 .Sh SEE ALSO
 .Xr jail 2 ,
-.Xr jail 3lua ,
 .Xr sysctl 3 ,
+.Xr jail 3lua ,
 .Xr jail 8
 .Sh HISTORY
 The
diff --git a/lib/libpam/modules/pam_chroot/pam_chroot.8 b/lib/libpam/modules/pam_chroot/pam_chroot.8
index e65c513b7b77..1f614264ba8e 100644
--- a/lib/libpam/modules/pam_chroot/pam_chroot.8
+++ b/lib/libpam/modules/pam_chroot/pam_chroot.8
@@ -78,8 +78,8 @@ Specify the chroot directory to use if one could not be derived from
 the user's home directory.
 .El
 .Sh SEE ALSO
-.Xr pam.conf 5 ,
-.Xr pam 3
+.Xr pam 3 ,
+.Xr pam.conf 5
 .Sh AUTHORS
 The
 .Nm
diff --git a/lib/libpam/modules/pam_deny/pam_deny.8 b/lib/libpam/modules/pam_deny/pam_deny.8
index 530bae05c1f3..5d70bde200d9 100644
--- a/lib/libpam/modules/pam_deny/pam_deny.8
+++ b/lib/libpam/modules/pam_deny/pam_deny.8
@@ -73,6 +73,6 @@ reasons why the user's
 authentication attempt was declined.
 .El
 .Sh SEE ALSO
+.Xr pam 3 ,
 .Xr syslog 3 ,
-.Xr pam.conf 5 ,
-.Xr pam 3
+.Xr pam.conf 5
diff --git a/lib/libpam/modules/pam_echo/pam_echo.8 b/lib/libpam/modules/pam_echo/pam_echo.8
index c38d4d8cee55..19c083917bbf 100644
--- a/lib/libpam/modules/pam_echo/pam_echo.8
+++ b/lib/libpam/modules/pam_echo/pam_echo.8
@@ -77,8 +77,8 @@ expands to the character following the
 .Cm %
 character.
 .Sh SEE ALSO
-.Xr pam.conf 5 ,
-.Xr pam 3
+.Xr pam 3 ,
+.Xr pam.conf 5
 .Sh AUTHORS
 The
 .Nm
diff --git a/lib/libpam/modules/pam_exec/pam_exec.8 b/lib/libpam/modules/pam_exec/pam_exec.8
index c77162955730..be5666003557 100644
--- a/lib/libpam/modules/pam_exec/pam_exec.8
+++ b/lib/libpam/modules/pam_exec/pam_exec.8
@@ -148,15 +148,15 @@ Each valid codes numerical value is available as an environment variable
 etc).
 This is useful in shell scripts for instance.
 .Sh SEE ALSO
-.Xr pam_get_item 3 ,
-.Xr pam.conf 5 ,
 .Xr pam 3 ,
+.Xr pam_get_item 3 ,
 .Xr pam_sm_acct_mgmt 3 ,
 .Xr pam_sm_authenticate 3 ,
 .Xr pam_sm_chauthtok 3 ,
 .Xr pam_sm_close_session 3 ,
 .Xr pam_sm_open_session 3 ,
-.Xr pam_sm_setcred 3
+.Xr pam_sm_setcred 3 ,
+.Xr pam.conf 5
 .Sh AUTHORS
 The
 .Nm
diff --git a/lib/libpam/modules/pam_ftpusers/pam_ftpusers.8 b/lib/libpam/modules/pam_ftpusers/pam_ftpusers.8
index a5c810fd2de5..d5a0f0f1fd2e 100644
--- a/lib/libpam/modules/pam_ftpusers/pam_ftpusers.8
+++ b/lib/libpam/modules/pam_ftpusers/pam_ftpusers.8
@@ -82,9 +82,9 @@ will succeed if and only if the user is not listed in
 .Pa /etc/ftpusers .
 .El
 .Sh SEE ALSO
+.Xr pam 3 ,
 .Xr ftpusers 5 ,
-.Xr pam.conf 5 ,
-.Xr pam 3
+.Xr pam.conf 5
 .Sh AUTHORS
 The
 .Nm
diff --git a/lib/libpam/modules/pam_group/pam_group.8 b/lib/libpam/modules/pam_group/pam_group.8
index ed96d45db503..315aaa6cc267 100644
--- a/lib/libpam/modules/pam_group/pam_group.8
+++ b/lib/libpam/modules/pam_group/pam_group.8
@@ -86,8 +86,8 @@ options are mutually exclusive, and that
 .Nm
 will fail if both are specified.
 .Sh SEE ALSO
-.Xr pam.conf 5 ,
-.Xr pam 3
+.Xr pam 3 ,
+.Xr pam.conf 5
 .Sh AUTHORS
 The
 .Nm
diff --git a/lib/libpam/modules/pam_guest/pam_guest.8 b/lib/libpam/modules/pam_guest/pam_guest.8
index 541fd299ba8b..c626187d5b19 100644
--- a/lib/libpam/modules/pam_guest/pam_guest.8
+++ b/lib/libpam/modules/pam_guest/pam_guest.8
@@ -80,10 +80,10 @@ password.
 Requires the guest user to type in the guest account name as password.
 .El
 .Sh SEE ALSO
+.Xr pam 3 ,
 .Xr pam_get_item 3 ,
 .Xr pam_getenv 3 ,
-.Xr pam.conf 5 ,
-.Xr pam 3
+.Xr pam.conf 5
 .Sh AUTHORS
 The
 .Nm
diff --git a/lib/libpam/modules/pam_krb5/pam_krb5.8 b/lib/libpam/modules/pam_krb5/pam_krb5.8
index b59fdbdee9c4..7c1770961272 100644
--- a/lib/libpam/modules/pam_krb5/pam_krb5.8
+++ b/lib/libpam/modules/pam_krb5/pam_krb5.8
@@ -222,9 +222,9 @@ file containing Kerberos principals that are allowed access.
 .Sh SEE ALSO
 .Xr kdestroy 1 ,
 .Xr passwd 1 ,
+.Xr pam 3 ,
 .Xr syslog 3 ,
-.Xr pam.conf 5 ,
-.Xr pam 3
+.Xr pam.conf 5
 .Sh NOTES
 Applications should not call
 .Fn pam_authenticate
diff --git a/lib/libpam/modules/pam_ksu/pam_ksu.8 b/lib/libpam/modules/pam_ksu/pam_ksu.8
index 36d6936423b1..ace570ea5b5b 100644
--- a/lib/libpam/modules/pam_ksu/pam_ksu.8
+++ b/lib/libpam/modules/pam_ksu/pam_ksu.8
@@ -115,6 +115,6 @@ the user is prompted for another password.
 .El
 .Sh SEE ALSO
 .Xr su 1 ,
+.Xr pam 3 ,
 .Xr syslog 3 ,
-.Xr pam.conf 5 ,
-.Xr pam 3
+.Xr pam.conf 5
diff --git a/lib/libpam/modules/pam_lastlog/pam_lastlog.8 b/lib/libpam/modules/pam_lastlog/pam_lastlog.8
index 6e5ba8770ada..e924016151fa 100644
--- a/lib/libpam/modules/pam_lastlog/pam_lastlog.8
+++ b/lib/libpam/modules/pam_lastlog/pam_lastlog.8
@@ -84,11 +84,11 @@ Ignore I/O failures.
 .Xr last 1 ,
 .Xr w 1 ,
 .Xr getutxent 3 ,
+.Xr pam 3 ,
 .Xr ulog_login 3 ,
 .Xr ulog_logout 3 ,
 .Xr pam.conf 5 ,
-.Xr lastlogin 8 ,
-.Xr pam 3
+.Xr lastlogin 8
 .Sh AUTHORS
 The
 .Nm
diff --git a/lib/libpam/modules/pam_nologin/pam_nologin.8 b/lib/libpam/modules/pam_nologin/pam_nologin.8
index 30f87a65b63e..ff49749e50f1 100644
--- a/lib/libpam/modules/pam_nologin/pam_nologin.8
+++ b/lib/libpam/modules/pam_nologin/pam_nologin.8
@@ -81,8 +81,8 @@ reasons why the user's
 login attempt was declined.
 .El
 .Sh SEE ALSO
+.Xr pam 3 ,
 .Xr syslog 3 ,
 .Xr login.conf 5 ,
 .Xr nologin 5 ,
-.Xr pam.conf 5 ,
-.Xr pam 3
+.Xr pam.conf 5
diff --git a/lib/libpam/modules/pam_passwdqc/pam_passwdqc.8 b/lib/libpam/modules/pam_passwdqc/pam_passwdqc.8
index f2ec1747d1f8..755e93520427 100644
--- a/lib/libpam/modules/pam_passwdqc/pam_passwdqc.8
+++ b/lib/libpam/modules/pam_passwdqc/pam_passwdqc.8
@@ -248,8 +248,8 @@ is that the former is incompatible with
 .El
 .Sh SEE ALSO
 .Xr getpwnam 3 ,
-.Xr pam.conf 5 ,
-.Xr pam 3
+.Xr pam 3 ,
+.Xr pam.conf 5
 .Sh AUTHORS
 The
 .Nm
diff --git a/lib/libpam/modules/pam_permit/pam_permit.8 b/lib/libpam/modules/pam_permit/pam_permit.8
index f0b2f5527066..270eaee8361d 100644
--- a/lib/libpam/modules/pam_permit/pam_permit.8
+++ b/lib/libpam/modules/pam_permit/pam_permit.8
@@ -68,6 +68,6 @@ debugging information at
 level.
 .El
 .Sh SEE ALSO
+.Xr pam 3 ,
 .Xr syslog 3 ,
-.Xr pam.conf 5 ,
-.Xr pam 3
+.Xr pam.conf 5
diff --git a/lib/libpam/modules/pam_radius/pam_radius.8 b/lib/libpam/modules/pam_radius/pam_radius.8
index 6b2d1ef1fa55..abc916dcfff6 100644
--- a/lib/libpam/modules/pam_radius/pam_radius.8
+++ b/lib/libpam/modules/pam_radius/pam_radius.8
@@ -123,9 +123,9 @@ The standard RADIUS client configuration file for
 .Nm
 .El
 .Sh SEE ALSO
+.Xr pam 3 ,
 .Xr passwd 5 ,
-.Xr radius.conf 5 ,
-.Xr pam 3
+.Xr radius.conf 5
 .Sh HISTORY
 The
 .Nm
diff --git a/lib/libpam/modules/pam_rhosts/pam_rhosts.8 b/lib/libpam/modules/pam_rhosts/pam_rhosts.8
index ea005738840c..1f9716b9a0ca 100644
--- a/lib/libpam/modules/pam_rhosts/pam_rhosts.8
+++ b/lib/libpam/modules/pam_rhosts/pam_rhosts.8
@@ -78,9 +78,9 @@ was declined.
 do not automatically fail if the target user's UID is 0.
 .El
 .Sh SEE ALSO
+.Xr pam 3 ,
 .Xr hosts.equiv 5 ,
-.Xr pam.conf 5 ,
-.Xr pam 3
+.Xr pam.conf 5
 .Sh AUTHORS
 The
 .Nm
diff --git a/lib/libpam/modules/pam_rootok/pam_rootok.8 b/lib/libpam/modules/pam_rootok/pam_rootok.8
index d1ab8226e2ca..fd0a6dd3791f 100644
--- a/lib/libpam/modules/pam_rootok/pam_rootok.8
+++ b/lib/libpam/modules/pam_rootok/pam_rootok.8
@@ -69,5 +69,5 @@ authentication attempt was declined.
 .El
 .Sh SEE ALSO
 .Xr getuid 2 ,
-.Xr pam.conf 5 ,
-.Xr pam 3
+.Xr pam 3 ,
+.Xr pam.conf 5
diff --git a/lib/libpam/modules/pam_securetty/pam_securetty.8 b/lib/libpam/modules/pam_securetty/pam_securetty.8
index b19979000978..582389cf101d 100644
--- a/lib/libpam/modules/pam_securetty/pam_securetty.8
+++ b/lib/libpam/modules/pam_securetty/pam_securetty.8
@@ -84,7 +84,7 @@ authentication attempt was declined.
 .El
 .Sh SEE ALSO
 .Xr getttynam 3 ,
+.Xr pam 3 ,
 .Xr syslog 3 ,
 .Xr pam.conf 5 ,
-.Xr ttys 5 ,
-.Xr pam 3
+.Xr ttys 5
diff --git a/lib/libpam/modules/pam_self/pam_self.8 b/lib/libpam/modules/pam_self/pam_self.8
index c3623998f0be..f875d671286b 100644
--- a/lib/libpam/modules/pam_self/pam_self.8
+++ b/lib/libpam/modules/pam_self/pam_self.8
@@ -80,8 +80,8 @@ do not automatically fail if the current real user ID is 0.
 .El
 .Sh SEE ALSO
 .Xr getuid 2 ,
-.Xr pam.conf 5 ,
-.Xr pam 3
+.Xr pam 3 ,
+.Xr pam.conf 5
 .Sh AUTHORS
 The
 .Nm
diff --git a/lib/libpam/modules/pam_ssh/pam_ssh.8 b/lib/libpam/modules/pam_ssh/pam_ssh.8
index e63930eb5340..3ef44d8b687b 100644
--- a/lib/libpam/modules/pam_ssh/pam_ssh.8
+++ b/lib/libpam/modules/pam_ssh/pam_ssh.8
@@ -138,8 +138,8 @@ SSH2 Ed25519 key
 .El
 .Sh SEE ALSO
 .Xr ssh-agent 1 ,
-.Xr pam.conf 5 ,
-.Xr pam 3
+.Xr pam 3 ,
+.Xr pam.conf 5
 .Sh AUTHORS
 The
 .Nm
diff --git a/lib/libpam/modules/pam_unix/pam_unix.8 b/lib/libpam/modules/pam_unix/pam_unix.8
index 170cf65f34db..5c2ae5cf52e2 100644
--- a/lib/libpam/modules/pam_unix/pam_unix.8
+++ b/lib/libpam/modules/pam_unix/pam_unix.8
@@ -201,10 +201,10 @@ password database.
 .Xr getlogin 2 ,
 .Xr crypt 3 ,
 .Xr getpwent 3 ,
+.Xr pam 3 ,
 .Xr syslog 3 ,
 .Xr nsswitch.conf 5 ,
 .Xr passwd 5 ,
-.Xr pam 3 ,
 .Xr pw 8 ,
 .Xr yp 8
 .Sh BUGS
diff --git a/lib/libsys/fhreadlink.2 b/lib/libsys/fhreadlink.2
index 222142de223e..2d8db95685da 100644
--- a/lib/libsys/fhreadlink.2
+++ b/lib/libsys/fhreadlink.2
@@ -86,8 +86,8 @@ The file handle
 is no longer valid
 .El
 .Sh SEE ALSO
-.Xr fhstat 2 ,
 .Xr fhlink 2 ,
+.Xr fhstat 2
 .Sh HISTORY
 The
 .Fn fhreadlink
diff --git a/lib/libsys/getrlimitusage.2 b/lib/libsys/getrlimitusage.2
index 2e3dc744ab23..e82e7b4443fd 100644
--- a/lib/libsys/getrlimitusage.2
+++ b/lib/libsys/getrlimitusage.2
@@ -92,7 +92,7 @@ and
 .Sh SEE ALSO
 .Xr procstat 1 ,
 .Xr getrlimit 2 ,
-.Xr setrlimit 2 .
+.Xr setrlimit 2
 .Sh HISTORY
 The
 .Fn getrlimitusage
diff --git a/lib/libsys/socket.2 b/lib/libsys/socket.2
index b2305df6f9fe..a383cbcc4d80 100644
--- a/lib/libsys/socket.2
+++ b/lib/libsys/socket.2
@@ -282,13 +282,10 @@ The socket type is not supported by the protocol.
 .Xr accept 2 ,
 .Xr bind 2 ,
 .Xr connect 2 ,
-.Xr divert 4 ,
 .Xr getpeername 2 ,
 .Xr getsockname 2 ,
 .Xr getsockopt 2 ,
 .Xr ioctl 2 ,
-.Xr ip 4 ,
-.Xr ip6 4 ,
 .Xr listen 2 ,
 .Xr read 2 ,
 .Xr recv 2 ,
@@ -299,6 +296,9 @@ The socket type is not supported by the protocol.
 .Xr write 2 ,
 .Xr CMSG_DATA 3 ,
 .Xr getprotoent 3 ,
+.Xr divert 4 ,
+.Xr ip 4 ,
+.Xr ip6 4 ,
 .Xr netgraph 4 ,
 .Xr protocols 5
 .Rs
diff --git a/lib/libsys/thr_kill.2 b/lib/libsys/thr_kill.2
index a18e53e61008..3252de13ed8c 100644
--- a/lib/libsys/thr_kill.2
+++ b/lib/libsys/thr_kill.2
@@ -109,12 +109,12 @@ The current process does not have sufficient privilege to check existence or
 send a signal to the specified process.
 .El
 .Sh SEE ALSO
+.Xr _umtx_op 2 ,
 .Xr kill 2 ,
 .Xr thr_exit 2 ,
 .Xr thr_new 2 ,
 .Xr thr_self 2 ,
 .Xr thr_set_name 2 ,
-.Xr _umtx_op 2 ,
 .Xr pthread_kill 3 ,
 .Xr signal 3
 .Sh STANDARDS
diff --git a/lib/libsys/x86/pkru.3 b/lib/libsys/x86/pkru.3
index 2bcb6a64baaa..7b5ceb025d62 100644
--- a/lib/libsys/x86/pkru.3
+++ b/lib/libsys/x86/pkru.3
@@ -195,7 +195,7 @@ and the range already has defined protection keys.
 .Xr mmap 2 ,
 .Xr mprotect 2 ,
 .Xr munmap 2 ,
-.Xr sysarch 2 .
+.Xr sysarch 2
 .Sh STANDARDS
 The
 .Nm
diff --git a/lib/libsysdecode/sysdecode_sctp_sinfo_flags.3 b/lib/libsysdecode/sysdecode_sctp_sinfo_flags.3
index e5995bff8329..4eb25187f0d0 100644
--- a/lib/libsysdecode/sysdecode_sctp_sinfo_flags.3
+++ b/lib/libsysdecode/sysdecode_sctp_sinfo_flags.3
@@ -46,5 +46,5 @@ to the stream
 .Fa fp .
 In particular, the embedded PR-SCTP policies are handled.
 .Sh SEE ALSO
-.Xr sysdecode 3
+.Xr sysdecode 3 ,
 .Xr sysdecode_sctp_pr_policy 3
diff --git a/lib/libthr/libthr.3 b/lib/libthr/libthr.3
index 7d0c7669654a..6d33f4c378ce 100644
--- a/lib/libthr/libthr.3
+++ b/lib/libthr/libthr.3
@@ -325,15 +325,15 @@ anyway.
 .Sh SEE ALSO
 .Xr ktrace 1 ,
 .Xr ld-elf.so.1 1 ,
-.Xr getrlimit 2 ,
+.Xr _umtx_op 2 ,
 .Xr errno 2 ,
+.Xr getrlimit 2 ,
 .Xr thr_exit 2 ,
 .Xr thr_kill 2 ,
 .Xr thr_kill2 2 ,
 .Xr thr_new 2 ,
 .Xr thr_self 2 ,
 .Xr thr_set_name 2 ,
-.Xr _umtx_op 2 ,
 .Xr dlclose 3 ,
 .Xr dlopen 3 ,
 .Xr getenv 3 ,
diff --git a/lib/libveriexec/veriexec.3 b/lib/libveriexec/veriexec.3
index 8fd5822c8067..b367fc5ea40f 100644
--- a/lib/libveriexec/veriexec.3
+++ b/lib/libveriexec/veriexec.3
@@ -59,5 +59,5 @@ If the signature does not match,
 .Va errno
 is set to the reason for the mismatch.
 .Sh SEE ALSO
-.Xr mac_veriexec 4
+.Xr mac_veriexec 4 ,
 .Xr veriexec 4
diff --git a/sbin/comcontrol/comcontrol.8 b/sbin/comcontrol/comcontrol.8
index c5fdb52992dc..bee0fdab102b 100644
--- a/sbin/comcontrol/comcontrol.8
+++ b/sbin/comcontrol/comcontrol.8
@@ -52,7 +52,7 @@ dialin devices, hardwired terminals
 dialout devices
 .El
 .Sh SEE ALSO
-.Xr stty 1 ,
+.Xr stty 1
 .Sh HISTORY
 Originally part of cgd's com package patches, version 0.2.1, to
 .Bx 386 0.1 .
diff --git a/sbin/newfs/newfs.8 b/sbin/newfs/newfs.8
index a7f792635aa9..5be4b5d03f74 100644
--- a/sbin/newfs/newfs.8
+++ b/sbin/newfs/newfs.8
@@ -350,13 +350,13 @@ than the historical defaults
 This large fragment size may lead to much wasted space
 on file systems that contain many small files.
 .Sh SEE ALSO
-.Xr fdformat 8 ,
 .Xr geom 4 ,
 .Xr disktab 5 ,
 .Xr fs 5 ,
 .Xr camcontrol 8 ,
 .Xr dump 8 ,
 .Xr dumpfs 8 ,
+.Xr fdformat 8 ,
 .Xr fsck 8 ,
 .Xr gjournal 8 ,
 .Xr gpart 8 ,
diff --git a/sbin/umount/umount.8 b/sbin/umount/umount.8
index 086980151d60..2c26ca868dae 100644
--- a/sbin/umount/umount.8
+++ b/sbin/umount/umount.8
@@ -187,8 +187,8 @@ file system table
 .Xr unmount 2 ,
 .Xr fstab 5 ,
 .Xr autounmountd 8 ,
-.Xr mount 8 ,
-.Xr mdconfig 8
+.Xr mdconfig 8 ,
+.Xr mount 8
 .Sh HISTORY
 A
 .Nm
diff --git a/share/man/man4/atopcase.4 b/share/man/man4/atopcase.4
index 33e47ec64ee8..a0c95a9e218f 100644
--- a/share/man/man4/atopcase.4
+++ b/share/man/man4/atopcase.4
@@ -101,9 +101,9 @@ device node.
 .El
 .Sh SEE ALSO
 .Xr acpi 4 ,
+.Xr loader.conf 5 ,
 .Xr backlight 8 ,
-.Xr loader 8 ,
-.Xr loader.conf 5 .
+.Xr loader 8
 .Sh HISTORY
 The
 .Nm
diff --git a/share/man/man4/cd.4 b/share/man/man4/cd.4
index b05e486af6b6..02bf96dbfc97 100644
--- a/share/man/man4/cd.4
+++ b/share/man/man4/cd.4
@@ -335,8 +335,8 @@ devices
 .Sh DIAGNOSTICS
 None.
 .Sh SEE ALSO
-.Xr cd9660 4 ,
 .Xr cam 4 ,
+.Xr cd9660 4 ,
 .Xr da 4 ,
 .Xr disklabel 8 ,
 .Xr cd 9
diff --git a/share/man/man4/cdce.4 b/share/man/man4/cdce.4
index 9d842e475d85..87a6f5da4b08 100644
--- a/share/man/man4/cdce.4
+++ b/share/man/man4/cdce.4
@@ -140,10 +140,10 @@ is running low on mbufs.
 .Xr intro 4 ,
 .Xr ipheth 4 ,
 .Xr netintro 4 ,
+.Xr u3g 4 ,
+.Xr ucom 4 ,
 .Xr urndis 4 ,
 .Xr usb 4 ,
-.Xr ucom 4 ,
-.Xr u3g 4 ,
 .Xr ifconfig 8
 .Rs
 .%T "Universal Serial Bus Class Definitions for Communication Devices"
diff --git a/share/man/man4/dummynet.4 b/share/man/man4/dummynet.4
index 81b1b33efb6e..ad82cb80011d 100644
--- a/share/man/man4/dummynet.4
+++ b/share/man/man4/dummynet.4
@@ -59,9 +59,9 @@ pipes.
 .Xr setsockopt 2 ,
 .Xr if_bridge 4 ,
 .Xr ip 4 ,
-.Xr ipfw 8 ,
-.Xr dnctl 8 ,
 .Xr pf.conf 5 ,
+.Xr dnctl 8 ,
+.Xr ipfw 8 ,
 .Xr sysctl 8
 .Sh HISTORY
 The
diff --git a/share/man/man4/ftgpio.4 b/share/man/man4/ftgpio.4
index e31457673fa5..7a5562841732 100644
--- a/share/man/man4/ftgpio.4
+++ b/share/man/man4/ftgpio.4
@@ -40,8 +40,8 @@ is a driver for the GPIO controller found on Fintek Super I/O chips.
 .Xr gpio 3 ,
 .Xr gpio 4 ,
 .Xr gpioled 4 ,
-.Xr gpioctl 8
 .Xr superio 4 ,
+.Xr gpioctl 8
 .Sh HISTORY
 The
 .Nm
diff --git a/share/man/man4/ipfirewall.4 b/share/man/man4/ipfirewall.4
index bfc571bcb595..691ed3d331c0 100644
--- a/share/man/man4/ipfirewall.4
+++ b/share/man/man4/ipfirewall.4
@@ -149,11 +149,11 @@ man page for a complete description of the
 capabilities and how to use it.
 .Sh SEE ALSO
 .Xr setsockopt 2 ,
+.Xr libalias 3 ,
 .Xr divert 4 ,
 .Xr ip 4 ,
 .Xr ip6 4 ,
 .Xr ipfw 8 ,
-.Xr libalias 3 ,
 .Xr natd 8 ,
 .Xr sysctl 8 ,
 .Xr syslogd 8 ,
diff --git a/share/man/man4/ipsec.4 b/share/man/man4/ipsec.4
index c5c9ed863385..2f0e13a2ad29 100644
--- a/share/man/man4/ipsec.4
+++ b/share/man/man4/ipsec.4
@@ -333,8 +333,8 @@ routines from looking into the IP payload.
 .Xr ipsec_set_policy 3 ,
 .Xr crypto 4 ,
 .Xr enc 4 ,
-.Xr if_ipsec 4 ,
 .Xr icmp6 4 ,
+.Xr if_ipsec 4 ,
 .Xr intro 4 ,
 .Xr ip6 4 ,
 .Xr setkey 8 ,
diff --git a/share/man/man4/lindebugfs.4 b/share/man/man4/lindebugfs.4
index 25a398a93f22..34a196007086 100644
--- a/share/man/man4/lindebugfs.4
+++ b/share/man/man4/lindebugfs.4
@@ -77,11 +77,11 @@ file system on
 .Pp
 .Dl "mount -t lindebugfs lindebugfs /sys/kernel/debug"
 .Sh SEE ALSO
+.Xr mount 1 ,
 .Xr linprocfs 4 ,
 .Xr linsysfs 4 ,
-.Xr pseudofs 9 ,
 .Xr linux 4 ,
-.Xr mount 1
+.Xr pseudofs 9
 .Sh HISTORY
 The
 .Nm
diff --git a/share/man/man4/mac_do.4 b/share/man/man4/mac_do.4
index ce9f8cf25a4a..aa84a71b4953 100644
--- a/share/man/man4/mac_do.4
+++ b/share/man/man4/mac_do.4
@@ -74,5 +74,5 @@ The following rule:
 means the user with the uid 1001 can execute processes as user with uid 80,
 all the users which belongs to the group gid 0 can execute processes as any user.
 .Sh SEE ALSO
-.Xr mac 4 ,
-.Xr mdo 1
+.Xr mdo 1 ,
+.Xr mac 4
diff --git a/share/man/man4/man4.aarch64/rk_gpio.4 b/share/man/man4/man4.aarch64/rk_gpio.4
index 69bcb1671f85..b5648662cf5e 100644
--- a/share/man/man4/man4.aarch64/rk_gpio.4
+++ b/share/man/man4/man4.aarch64/rk_gpio.4
@@ -47,7 +47,7 @@ rockchip,gpio-bank
 .El
 .Sh SEE ALSO
 .Xr gpiobus 4 ,
-.Xr gpioctl 8 ,
+.Xr gpioctl 8
 .Sh HISTORY
 The
 .Nm
diff --git a/share/man/man4/man4.aarch64/rk_i2c.4 b/share/man/man4/man4.aarch64/rk_i2c.4
index f30b510e7655..be1a0fab943e 100644
--- a/share/man/man4/man4.aarch64/rk_i2c.4
+++ b/share/man/man4/man4.aarch64/rk_i2c.4
@@ -49,7 +49,7 @@ rockchip,rk3328-i2c
 .El
 .Sh SEE ALSO
 .Xr iic 4 ,
-.Xr iicbus 4 ,
+.Xr iicbus 4
 .Sh HISTORY
 The
 .Nm
diff --git a/share/man/man4/man4.aarch64/rk_pinctrl.4 b/share/man/man4/man4.aarch64/rk_pinctrl.4
index c196c00d52b7..519b3e793cd1 100644
--- a/share/man/man4/man4.aarch64/rk_pinctrl.4
+++ b/share/man/man4/man4.aarch64/rk_pinctrl.4
@@ -46,7 +46,7 @@ compatible strings :
 rockchip,rk3328-pinctrl
 .El
 .Sh SEE ALSO
-.Xr fdt_pinctrl 4 ,
+.Xr fdt_pinctrl 4
 .Sh HISTORY
 The
 .Nm
diff --git a/share/man/man4/man4.arm/imx6_ahci.4 b/share/man/man4/man4.arm/imx6_ahci.4
index cfe8a87deb6f..9979cef50d79 100644
--- a/share/man/man4/man4.arm/imx6_ahci.4
+++ b/share/man/man4/man4.arm/imx6_ahci.4
@@ -55,7 +55,7 @@ data and marshall resources for the standard
 driver.
 .Sh SEE ALSO
 .Xr ahci 4 ,
-.Xr fdt 4 ,
+.Xr fdt 4
 .Sh HISTORY
 The
 .Nm
diff --git a/share/man/man4/mpi3mr.4 b/share/man/man4/mpi3mr.4
index 981979e37187..f07ce13d2f23 100644
--- a/share/man/man4/mpi3mr.4
+++ b/share/man/man4/mpi3mr.4
@@ -64,7 +64,7 @@ Broadcom Ltd. 9600-8i8e 24G PCIe 4.0 Tri-Mode RAID Adapters
 .Xr mpr 4 ,
 .Xr pci 4 ,
 .Xr sa 4 ,
-.Xr scsi 4 .
+.Xr scsi 4
 .Sh HISTORY
 The
 .Nm
diff --git a/share/man/man4/netmap.4 b/share/man/man4/netmap.4
index e258b60e11f6..6c5737c9b1a0 100644
--- a/share/man/man4/netmap.4
+++ b/share/man/man4/netmap.4
@@ -1123,10 +1123,10 @@ with the network card or the host.
 .Sh SEE ALSO
 .Xr vale 4 ,
 .Xr bridge 8 ,
-.Xr valectl 8 ,
 .Xr lb 8 ,
 .Xr nmreplay 8 ,
-.Xr pkt-gen 8
+.Xr pkt-gen 8 ,
+.Xr valectl 8
 .Pp
 .Pa http://info.iet.unipi.it/~luigi/netmap/
 .Pp
diff --git a/share/man/man4/ng_nat.4 b/share/man/man4/ng_nat.4
index 10615b3b387d..53cd841a7392 100644
--- a/share/man/man4/ng_nat.4
+++ b/share/man/man4/ng_nat.4
@@ -396,8 +396,8 @@ SEQ
 .Xr libalias 3 ,
 .Xr ng_ipfw 4 ,
 .Xr natd 8 ,
-.Xr ngctl 8 ,
-.Xr ng_ether 8
+.Xr ng_ether 8 ,
+.Xr ngctl 8
 .Sh HISTORY
 The
 .Nm
diff --git a/share/man/man4/ng_pppoe.4 b/share/man/man4/ng_pppoe.4
index 346b2bfbe279..5b5f0dd64de2 100644
--- a/share/man/man4/ng_pppoe.4
+++ b/share/man/man4/ng_pppoe.4
@@ -565,9 +565,9 @@ setup(char *ethername, char *service, char *sessname,
 .Xr ng_ether 4 ,
 .Xr ng_ppp 4 ,
 .Xr ng_socket 4 ,
+.Xr vlan 4 ,
 .Xr ngctl 8 ,
-.Xr ppp 8 ,
-.Xr vlan 4
+.Xr ppp 8
 .Rs
 .%A L. Mamakos
 .%A K. Lidl
diff --git a/share/man/man4/procdesc.4 b/share/man/man4/procdesc.4
index d0b99e5cbe07..f1f3757aa836 100644
--- a/share/man/man4/procdesc.4
+++ b/share/man/man4/procdesc.4
@@ -58,10 +58,10 @@ Given a process descriptor, it is possible to query its conventional PID using
 .Sh SEE ALSO
 .Xr fork 2 ,
 .Xr kill 2 ,
+.Xr kqueue 2 ,
 .Xr pdfork 2 ,
 .Xr pdgetpid 2 ,
 .Xr pdkill 2 ,
-.Xr kqueue 2 ,
 .Xr wait4 2 ,
 .Xr capsicum 4
 .Sh HISTORY
diff --git a/share/man/man4/virtio_gpu.4 b/share/man/man4/virtio_gpu.4
index bb34ec419df6..f8d48faa05f0 100644
--- a/share/man/man4/virtio_gpu.4
+++ b/share/man/man4/virtio_gpu.4
@@ -46,7 +46,7 @@ device driver provides support for VirtIO gpu devices to create a
 .Xr vt 4
 console.
 .Sh SEE ALSO
-.Xr virtio 4
+.Xr virtio 4 ,
 .Xr vt 4
 .Sh HISTORY
 The
diff --git a/share/man/man5/pf.conf.5 b/share/man/man5/pf.conf.5
index 2edc7b1fb280..e461d9ac63b6 100644
--- a/share/man/man5/pf.conf.5
+++ b/share/man/man5/pf.conf.5
@@ -3438,8 +3438,8 @@ Service name database.
 .Xr pf 4 ,
 .Xr pflow 4 ,
 .Xr pfsync 4 ,
-.Xr tcp 4 ,
 .Xr sctp 4 ,
+.Xr tcp 4 ,
 .Xr udp 4 ,
 .Xr hosts 5 ,
 .Xr pf.os 5 ,
diff --git a/share/man/man8/rc.subr.8 b/share/man/man8/rc.subr.8
index 7dda3e8dae3f..36d7d4543e52 100644
--- a/share/man/man8/rc.subr.8
+++ b/share/man/man8/rc.subr.8
@@ -1180,8 +1180,8 @@ file resides in
 .Pa /etc .
 .El
 .Sh SEE ALSO
-.Xr debug.sh 8 ,
 .Xr rc.conf 5 ,
+.Xr debug.sh 8 ,
 .Xr rc 8
 .Sh HISTORY
 The
diff --git a/share/man/man8/uefi.8 b/share/man/man8/uefi.8
*** 308 LINES SKIPPED ***