git: ddf4df54a7d3 - stable/14 - manuals: Fix "unusual .Xr" warnings with a script
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Mon, 04 Nov 2024 16:16:47 UTC
The branch stable/14 has been updated by mhorne:
URL: https://cgit.FreeBSD.org/src/commit/?id=ddf4df54a7d3bf3df2cf929307e677acf86b06e2
commit ddf4df54a7d3bf3df2cf929307e677acf86b06e2
Author: Graham Percival <gperciva@tarsnap.com>
AuthorDate: 2024-10-15 15:44:42 +0000
Commit: Mitchell Horne <mhorne@FreeBSD.org>
CommitDate: 2024-11-04 16:13:13 +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
(cherry picked from commit 6e1fc0118033f42b7c0d3623c8f67a89ebecabb2)
---
lib/libc/gen/posix_spawn.3 | 4 ++--
lib/libc/gen/setproctitle.3 | 4 ++--
lib/libc/string/bstring.3 | 1 -
lib/libc/sys/fhreadlink.2 | 2 +-
lib/libc/sys/getrlimitusage.2 | 2 +-
lib/libc/sys/socket.2 | 6 +++---
lib/libc/sys/thr_kill.2 | 2 +-
lib/libc/x86/sys/pkru.3 | 2 +-
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/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 | 1 +
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/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/lindebugfs.5 | 2 +-
share/man/man5/pf.conf.5 | 2 +-
share/man/man8/rc.subr.8 | 1 +
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/i2c/i2c.8 | 2 +-
usr.sbin/lastlogin/lastlogin.8 | 4 ++--
usr.sbin/mailwrapper/mailwrapper.8 | 2 +-
usr.sbin/rpc.tlsclntd/rpc.tlsclntd.8 | 2 +-
74 files changed, 120 insertions(+), 119 deletions(-)
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/string/bstring.3 b/lib/libc/string/bstring.3
index bb1a0505fafd..dc3034db1d6c 100644
--- a/lib/libc/string/bstring.3
+++ b/lib/libc/string/bstring.3
@@ -85,7 +85,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/libc/sys/fhreadlink.2 b/lib/libc/sys/fhreadlink.2
index 222142de223e..2d8db95685da 100644
--- a/lib/libc/sys/fhreadlink.2
+++ b/lib/libc/sys/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/libc/sys/getrlimitusage.2 b/lib/libc/sys/getrlimitusage.2
index 2e3dc744ab23..e82e7b4443fd 100644
--- a/lib/libc/sys/getrlimitusage.2
+++ b/lib/libc/sys/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/libc/sys/socket.2 b/lib/libc/sys/socket.2
index 3e2206aefe72..9c2b2f8f925b 100644
--- a/lib/libc/sys/socket.2
+++ b/lib/libc/sys/socket.2
@@ -284,13 +284,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 ,
@@ -301,6 +298,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/libc/sys/thr_kill.2 b/lib/libc/sys/thr_kill.2
index a18e53e61008..3252de13ed8c 100644
--- a/lib/libc/sys/thr_kill.2
+++ b/lib/libc/sys/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/libc/x86/sys/pkru.3 b/lib/libc/x86/sys/pkru.3
index 2bcb6a64baaa..7b5ceb025d62 100644
--- a/lib/libc/x86/sys/pkru.3
+++ b/lib/libc/x86/sys/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/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/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 46c7f987d774..e050452498b9 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 0dc93cb8b78d..4ac6e56879b4 100644
--- a/sbin/newfs/newfs.8
+++ b/sbin/newfs/newfs.8
@@ -352,13 +352,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 fc93b7094466..830c67f872a4 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 7c3fa6ed9850..0260d5ec5a8f 100644
--- a/share/man/man4/cd.4
+++ b/share/man/man4/cd.4
@@ -336,6 +336,7 @@ devices
None.
.Sh SEE ALSO
.Xr cam 4 ,
+.Xr cd9660 4 ,
.Xr da 4 ,
.Xr cd9660 5 ,
.Xr disklabel 8 ,
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 952d7b925388..96a10dfb7700 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/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 5a12f8f32465..6be0c8662d59 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/lindebugfs.5 b/share/man/man5/lindebugfs.5
index 8e385be7d743..4e823baff132 100644
--- a/share/man/man5/lindebugfs.5
+++ b/share/man/man5/lindebugfs.5
@@ -81,7 +81,7 @@ file system on
.Xr linsysfs 5 ,
.Xr pseudofs 9 ,
.Xr linux 4 ,
-.Xr mount 1
+.Xr pseudofs 9
.Sh HISTORY
The
.Nm
diff --git a/share/man/man5/pf.conf.5 b/share/man/man5/pf.conf.5
index 3193c18760c8..7e2db95fd961 100644
--- a/share/man/man5/pf.conf.5
+++ b/share/man/man5/pf.conf.5
@@ -3407,8 +3407,8 @@ Service name database.
.Xr ip6 4 ,
.Xr pf 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 2dd46cf50c2b..844ba0356692 100644
--- a/share/man/man8/rc.subr.8
+++ b/share/man/man8/rc.subr.8
@@ -945,6 +945,7 @@ file resides in
.El
.Sh SEE ALSO
.Xr rc.conf 5 ,
+.Xr debug.sh 8 ,
.Xr rc 8
.Sh HISTORY
The
diff --git a/share/man/man9/VOP_SETLABEL.9 b/share/man/man9/VOP_SETLABEL.9
index e5cf99bebd86..4ab7dd9beaba 100644
--- 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 .
diff --git a/share/man/man9/cr_bsd_visible.9 b/share/man/man9/cr_bsd_visible.9
index f2d42f3835dc..d16f4bb6dd8f 100644
--- 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
*** 228 LINES SKIPPED ***