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
2024-11-21 10:41:46 +01:00 · 2024-10-15 08:44:42 -07:00 · 2024-10-15 08:44:42 -07:00 · 6e1fc01180
commit 6e1fc01180
parent c3294033e0
79 changed files with 126 additions and 127 deletions
--- 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
--- 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 ,
--- 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
--- 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 ,
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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 ,
--- 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
--- 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 .
--- 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 ,
--- 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
--- 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
--- 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
--- 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"
--- 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
--- 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
--- 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 ,
--- 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 ,
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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 ,
--- 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
--- a/share/man/man8/uefi.8
+++ b/share/man/man8/uefi.8
@ -108,9 +108,9 @@ Default kernel
 Typical non-default kernel (optional)
 .El
 .Sh SEE ALSO
+.Xr msdosfs 4 ,
 .Xr vt 4 ,
 .Xr boot.config 5 ,
-.Xr msdosfs 4 ,
 .Xr boot 8 ,
 .Xr efibootmgr 8 ,
 .Xr efidp 8 ,
--- a/share/man/man9/VOP_SETLABEL.9
+++ b/share/man/man9/VOP_SETLABEL.9
@ -113,13 +113,13 @@ Depending on the underlying implementation of
 .Fn VOP_SETLABEL ,
 other errors may also be possible.
 .Sh SEE ALSO
+.Xr mac 9 ,
+.Xr mount 9 ,
+.Xr vnode 9 ,
 .Xr VOP_CLOSEEXTATTR 9 ,
 .Xr VOP_OPENEXTATTR 9 ,
 .Xr VOP_READEXTATTR 9 ,
-.Xr VOP_WRITEXTATTR 9 ,
-.Xr mac 9 ,
-.Xr mount 9 ,
-.Xr vnode 9
+.Xr VOP_WRITEXTATTR 9
 .Sh AUTHORS
 This manual page was written by
 .An Robert Watson .
--- a/share/man/man9/cr_bsd_visible.9
+++ b/share/man/man9/cr_bsd_visible.9
@ -107,11 +107,11 @@ and
 are not in the same jail.
 .El
 .Sh SEE ALSO
-.Xr cr_canseeotheruids 9 ,
-.Xr cr_canseeothergids 9 ,
+.Xr cr_cansee 9 ,
 .Xr cr_canseejailproc 9 ,
-.Xr priv_check_cred 9 ,
-.Xr cr_cansee 9
+.Xr cr_canseeothergids 9 ,
+.Xr cr_canseeotheruids 9 ,
+.Xr priv_check_cred 9
 .Sh AUTHORS
 This function and its manual page were written by
 .An Olivier Certner Aq Mt olce.freebsd@certner.fr .
--- a/share/man/man9/cr_cansee.9
+++ b/share/man/man9/cr_cansee.9
@ -77,7 +77,7 @@ The MAC subsystem denied visibility.
 denied visibility according to the BSD security policies in force.
 .El
 .Sh SEE ALSO
-.Xr prison_check 9 ,
-.Xr mac 9 ,
 .Xr cr_bsd_visible 9 ,
-.Xr p_cansee 9
+.Xr mac 9 ,
+.Xr p_cansee 9 ,
+.Xr prison_check 9
--- a/share/man/man9/cr_canseeothergids.9
+++ b/share/man/man9/cr_canseeothergids.9
@ -79,5 +79,5 @@ Otherwise, it returns
 .Er ESRCH .
 .Sh SEE ALSO
 .Xr cr_bsd_visible 9 ,
-.Xr realgroupmember 9 ,
-.Xr priv_check_cred 9
+.Xr priv_check_cred 9 ,
+.Xr realgroupmember 9
--- a/share/man/man9/groupmember.9
+++ b/share/man/man9/groupmember.9
@ -69,7 +69,7 @@ or
 .Dv false
 otherwise.
 .Sh SEE ALSO
-.Xr getgroups 2
+.Xr getgroups 2 ,
 .Xr setgroups 2
 .Sh AUTHORS
 This manual page was initially written by
--- a/share/man/man9/p_candebug.9
+++ b/share/man/man9/p_candebug.9
@ -138,8 +138,8 @@ command
 .Pc .
 .El
 .Sh SEE ALSO
-.Xr prison_check 9 ,
-.Xr mac 9 ,
-.Xr cr_bsd_visible 9 ,
 .Xr procctl 2 ,
-.Xr p_cansee 9
+.Xr cr_bsd_visible 9 ,
+.Xr mac 9 ,
+.Xr p_cansee 9 ,
+.Xr prison_check 9
--- a/share/man/man9/p_cansee.9
+++ b/share/man/man9/p_cansee.9
@ -74,6 +74,6 @@ and cannot see it as determined by
 .Xr cr_cansee 9 .
 .El
 .Sh SEE ALSO
-.Xr ucred 9 ,
 .Xr cr_cansee 9 ,
-.Xr p_candebug 9
+.Xr p_candebug 9 ,
+.Xr ucred 9
--- a/share/man/man9/rtentry.9
+++ b/share/man/man9/rtentry.9
@ -227,7 +227,7 @@ Empty space available for protocol-specific information.
 .El
 .Sh SEE ALSO
 .Xr route 4 ,
-.Xr route 8 ,
+.Xr route 8
 .Sh HISTORY
 The
 .Vt rtentry
--- a/tools/tools/ether_reflect/ether_reflect.1
+++ b/tools/tools/ether_reflect/ether_reflect.1
@ -94,8 +94,8 @@ Rewrite the destination address in each packet to 00:00:00:aa:bb:cc
 before reflecting the packet.
 .Sh SEE ALSO
 .Xr tcpdump 1 ,
-.Xr bpf 4 ,
 .Xr pcap 3 ,
+.Xr bpf 4 ,
 .Xr ifconfig 8
 .Sh HISTORY
 The
--- a/usr.bin/beep/beep.1
+++ b/usr.bin/beep/beep.1
@ -73,7 +73,7 @@ Playback default beep sound using /dev/dsp .
 .El
 .Sh SEE ALSO
 .Xr mixer 3 ,
-.Xr sound 4 ,
+.Xr sound 4
 .Sh HISTORY
 The
 .Nm
--- a/usr.bin/gzip/gzip.1
+++ b/usr.bin/gzip/gzip.1
@ -202,8 +202,8 @@ Report progress to standard error.
 .Sh SEE ALSO
 .Xr bzip2 1 ,
 .Xr compress 1 ,
-.Xr zstd 1 ,
 .Xr xz 1 ,
+.Xr zstd 1 ,
 .Xr fts 3 ,
 .Xr zlib 3
 .Sh HISTORY
--- a/usr.bin/mdo/mdo.1
+++ b/usr.bin/mdo/mdo.1
@ -40,5 +40,5 @@ option can be used to only call
 .Fn setuid
 and keep the group from the calling user.
 .Sh SEE ALSO
-.Xr su 1
+.Xr su 1 ,
 .Xr mac_do 4
--- a/usr.bin/msgs/msgs.1
+++ b/usr.bin/msgs/msgs.1
@ -218,8 +218,8 @@ database
 number of next message to be presented
 .El
 .Sh SEE ALSO
-.Xr mail 1 ,
 .Xr less 1 ,
+.Xr mail 1 ,
 .Xr aliases 5 ,
 .Xr periodic 8
 .Sh HISTORY
--- a/usr.bin/posixmqcontrol/posixmqcontrol.1
+++ b/usr.bin/posixmqcontrol/posixmqcontrol.1
@ -158,8 +158,8 @@ use the command
 .Dl "posixmqcontrol info -q /4"
 .El
 .Sh SEE ALSO
-.Xr mq_open 2 ,
 .Xr mq_getattr 2 ,
+.Xr mq_open 2 ,
 .Xr mq_receive 2 ,
 .Xr mq_send 2 ,
 .Xr mq_setattr 2 ,
--- a/usr.sbin/efibootmgr/efibootmgr.8
+++ b/usr.sbin/efibootmgr/efibootmgr.8
@ -282,7 +282,7 @@ for the next reboot use:
 .Xr gpart 8 ,
 .Xr loader.efi 8 ,
 .Xr uefi 8 ,
-.Xr efirt 9 ,
+.Xr efirt 9
 .Sh STANDARDS
 The Unified Extensible Firmware Interface Specification is available
 from
--- a/usr.sbin/i2c/i2c.8
+++ b/usr.sbin/i2c/i2c.8
@ -204,7 +204,7 @@ Reading these can disturb the firmware's operation and writing to them
 can "brick" the hardware.
 .Sh SEE ALSO
 .Xr iic 4 ,
-.Xr iicbus 4
+.Xr iicbus 4 ,
 .Xr smbus 4
 .Sh HISTORY
 The
--- a/usr.sbin/jail/jail.8
+++ b/usr.sbin/jail/jail.8
@ -1443,8 +1443,8 @@ environment of the first jail.
 .Xr quota 1 ,
 .Xr adjtime 2 ,
 .Xr clock_settime 2 ,
-.Xr ntp_adjtime 2 ,
 .Xr jail_set 2 ,
+.Xr ntp_adjtime 2 ,
 .Xr devfs 4 ,
 .Xr fdescfs 4 ,
 .Xr linprocfs 4 ,
--- a/usr.sbin/lastlogin/lastlogin.8
+++ b/usr.sbin/lastlogin/lastlogin.8
@ -92,9 +92,9 @@ last login database
 .Sh SEE ALSO
 .Xr last 1 ,
 .Xr getutxent 3 ,
-.Xr ac 8 ,
 .Xr libxo 3 ,
-.Xr xo_parse_args 3
+.Xr xo_parse_args 3 ,
+.Xr ac 8
 .Sh AUTHORS
 .An -nosplit
 .An John M. Vinopal
--- a/usr.sbin/mailwrapper/mailwrapper.8
+++ b/usr.sbin/mailwrapper/mailwrapper.8
@ -165,12 +165,12 @@ The
 will print a diagnostic if its configuration file is missing or malformed,
 or does not contain a mapping for the name under which it was invoked.
 .Sh SEE ALSO
-.Xr dma 8 ,
 .Xr mail 1 ,
 .Xr mailq 1 ,
 .Xr newaliases 1 ,
 .Xr mailer.conf 5 ,
 .Xr periodic.conf 5 ,
+.Xr dma 8 ,
 .Xr sendmail 8
 .Sh HISTORY
 The
--- a/usr.sbin/rpc.tlsclntd/rpc.tlsclntd.8
+++ b/usr.sbin/rpc.tlsclntd/rpc.tlsclntd.8
@ -194,9 +194,9 @@ option has also been specified.
 .Sh SEE ALSO
 .Xr openssl 1 ,
 .Xr ktls 4 ,
+.Xr ssl 7 ,
 .Xr mount_nfs 8 ,
 .Xr rpc.tlsservd 8 ,
-.Xr ssl 7 ,
 .Xr syslogd 8
 .Sh STANDARDS
 The implementation is based on the specification in