From 973101df9329edca6a7f31c112d1969ff070e0a9 Mon Sep 17 00:00:00 2001
From: Alexander Ziaee <concussious@runbox.com>
Date: Wed, 18 Dec 2024 13:06:41 -0500
Subject: [PATCH] msdosfs manuals: Improve visibility and linking

+ add `(FAT)` to all descriptions to enable `apropos fat`
+ xref all msdosfs(4) utilities in base to msdosfs(4)
+ xref msdosfs(4) to all msdosfs(4) utilities
+ remove unrelated fsck_ffs(8) from fsck_msdos(8)

MFC after:	3 days
---
 sbin/fsck_msdosfs/fsck_msdosfs.8   | 5 ++---
 sbin/mount_msdosfs/mount_msdosfs.8 | 2 +-
 sbin/newfs_msdos/newfs_msdos.8     | 1 +
 share/man/man4/msdosfs.4           | 4 +++-
 4 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/sbin/fsck_msdosfs/fsck_msdosfs.8 b/sbin/fsck_msdosfs/fsck_msdosfs.8
index a74649e0c47e83..7c90c8b11b5d84 100644
--- a/sbin/fsck_msdosfs/fsck_msdosfs.8
+++ b/sbin/fsck_msdosfs/fsck_msdosfs.8
@@ -125,9 +125,8 @@ to assume
 as the answer to all operator questions.
 .El
 .Sh SEE ALSO
-.Xr fsck 8 ,
-.Xr fsck_ffs 8 ,
-.Xr mount_msdosfs 8
+.Xr msdosfs 4 ,
+.Xr fsck 8
 .Sh HISTORY
 The
 .Nm
diff --git a/sbin/mount_msdosfs/mount_msdosfs.8 b/sbin/mount_msdosfs/mount_msdosfs.8
index 3a97089e220c1d..4ae3e69601229c 100644
--- a/sbin/mount_msdosfs/mount_msdosfs.8
+++ b/sbin/mount_msdosfs/mount_msdosfs.8
@@ -33,7 +33,7 @@
 .Os
 .Sh NAME
 .Nm mount_msdosfs
-.Nd mount an MS-DOS file system
+.Nd mount an MS-DOS (FAT) file system
 .Sh SYNOPSIS
 .Nm
 .Op Fl 9ls
diff --git a/sbin/newfs_msdos/newfs_msdos.8 b/sbin/newfs_msdos/newfs_msdos.8
index 92e407ab81afbe..03dfbfced51fbc 100644
--- a/sbin/newfs_msdos/newfs_msdos.8
+++ b/sbin/newfs_msdos/newfs_msdos.8
@@ -252,6 +252,7 @@ Create a 30MB image file, with the FAT partition starting
 newfs_msdos -C 30M -@63s ./somefile
 .Ed
 .Sh SEE ALSO
+.Xr msdosfs 4 ,
 .Xr gpart 8 ,
 .Xr newfs 8
 .Sh HISTORY
diff --git a/share/man/man4/msdosfs.4 b/share/man/man4/msdosfs.4
index df937311060bc2..d823934dcfd1b7 100644
--- a/share/man/man4/msdosfs.4
+++ b/share/man/man4/msdosfs.4
@@ -6,7 +6,7 @@
 .Os
 .Sh NAME
 .Nm msdosfs
-.Nd MS-DOS file system
+.Nd MS-DOS (FAT) file system
 .Sh SYNOPSIS
 .Cd "options MSDOSFS"
 .Sh DESCRIPTION
@@ -65,8 +65,10 @@ may also be used to extract this information.
 .Sh SEE ALSO
 .Xr mount 2 ,
 .Xr unmount 2 ,
+.Xr fsck_msdosfs 8 ,
 .Xr mount 8 ,
 .Xr mount_msdosfs 8 ,
+.Xr newfs_msdos 8 ,
 .Xr umount 8
 .Sh AUTHORS
 This manual page was written by