7 files changed, 111 insertions, 15 deletions
diff --git a/share/man/man4/cd9660.4 b/share/man/man4/cd9660.4
index 0e4fd33637cb..a684df37bab9 100644
--- a/share/man/man4/cd9660.4
+++ b/share/man/man4/cd9660.4
@@ -1,4 +1,6 @@
 .\"
+.\" SPDX-License-Identifier: BSD-3-Clause
+.\"
 .\" Copyright (c) 2017 Enji Cooper
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -23,7 +25,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd April 25, 2023
+.Dd January 18, 2025
 .Dt CD9660 4
 .Os
 .Sh NAME
@@ -57,6 +59,7 @@ volume located on
 .Pp
 .Dl "mount -t cd9660 /dev/cd0 /mnt"
 .Sh SEE ALSO
+.Xr etdump 1 ,
 .Xr nmount 2 ,
 .Xr unmount 2 ,
 .Xr cd 4 ,
diff --git a/share/man/man4/man4.aarch64/Makefile b/share/man/man4/man4.aarch64/Makefile
index aca11eeb583f..0e85aab8b770 100644
--- a/share/man/man4/man4.aarch64/Makefile
+++ b/share/man/man4/man4.aarch64/Makefile
@@ -6,6 +6,7 @@ MAN=	\
 	felix.4 \
 	rk_gpio.4 \
 	rk_grf.4 \
+	rk_grf_gpio.4 \
 	rk_i2c.4 \
 	rk_pinctrl.4 \
 
diff --git a/share/man/man4/man4.aarch64/rk_grf_gpio.4 b/share/man/man4/man4.aarch64/rk_grf_gpio.4
new file mode 100644
index 000000000000..6a5ebbe19e3b
--- /dev/null
+++ b/share/man/man4/man4.aarch64/rk_grf_gpio.4
@@ -0,0 +1,42 @@
+.\"
+.\" Copyright (c) 2025 Stephen Hurd <shurd@freebsd.org>
+.\"
+.\" SPDX-License-Identifier: BSD-2-Clause
+.\"
+.Dd March 18, 2025
+.Dt RK_GRF_GPIO 4
+.Os
+.Sh NAME
+.Nm rk_grf_gpio
+.Nd RockChip GPIO_MUTE pin driver
+.Sh SYNOPSIS
+.Cd "options SOC_ROCKCHIP_rk3328"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides a single-pin, output-only
+.Xr gpio 3
+unit whose single pin is named GPIO_MUTE.
+This controls the output of the GPIO_MUTE pin on the SoC.
+.Pp
+This gpio is usually used to control another device on the board,
+so is not usually available for user software.
+.Sh HARDWARE
+The
+.Nm
+driver supports the following GRF GPIO controller:
+.Pp
+.Bl -bullet -compact
+.It
+rockchip,rk3328-grf-gpio
+.El
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Fx 15.0 .
+.Sh AUTHORS
+The
+.Nm
+driver and manual were written by
+.An Stephen Hurd Aq Mt shurd@freebsd.org .
diff --git a/share/man/man5/intro.5 b/share/man/man5/intro.5
index 78e147975e81..3e67b319da14 100644
--- a/share/man/man5/intro.5
+++ b/share/man/man5/intro.5
@@ -1,3 +1,6 @@
+.\"
+.\" SPDX-License-Identifier: BSD-3-Clause
+.\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
 .\"
@@ -25,25 +28,41 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd February 16, 1997
+.Dd November 17, 2024
 .Dt INTRO 5
 .Os
 .Sh NAME
 .Nm intro
-.Nd "introduction to file formats"
+.Nd introduction to file formats
 .Sh DESCRIPTION
-This section contains information about file formats.
+This section contains information about the file formats
+which comprise most data structures in the
+.Bx
+environment, including:
+.Pp
+.Bl -bullet -compact
+.It
+.Xr ascii 7
+configuration and resource files
+.It
+system binary file and stream structures
+.It
+composition of database files
+.El
 .Sh FILES
-.Bl -tag -width /etc/shells -compact
-.It Pa /etc
-location of most system configuration files
+.Bl -tag -width "/usr/local/etc/" -compact
+.It Pa /etc/
+base system software configuration files
+.It Pa /usr/local/etc/
+locally installed software configuration files
 .El
 .Sh SEE ALSO
 .Xr apropos 1 ,
 .Xr intro 1 ,
+.Xr hier 7 ,
 .Xr intro 8
 .Sh HISTORY
 The
-.Nm
-section manual page appeared in
+.Nm Ns Pq 5
+manual page first appeared in
 .Fx 2.2 .
diff --git a/share/man/man5/style.mdoc.5 b/share/man/man5/style.mdoc.5
index dd4d8a1f5fdf..d96c9ff08bbb 100644
--- a/share/man/man5/style.mdoc.5
+++ b/share/man/man5/style.mdoc.5
@@ -1,4 +1,4 @@
-.\"-
+.\"
 .\" SPDX-License-Identifier: BSD-2-Clause
 .\"
 .\" Copyright (c) 2018-2022 Mateusz Piotrowski <0mp@FreeBSD.org>
@@ -24,7 +24,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd December 12, 2024
+.Dd December 21, 2024
 .Dt STYLE.MDOC 5
 .Os
 .Sh NAME
@@ -74,6 +74,33 @@ Historically,
 was the preferred way before the deprecation of
 .Sy \&Li .
 .El
+.Ss HARDWARE Section
+Driver manuals in section four should have a
+.Sx HARDWARE
+section describing hardware known to work with the driver.
+This section is drawn verbatim into the Release Hardware Notes,
+therefore there are several things to note:
+.Bl -dash -width ""
+.It
+The introductory sentence should be in the form:
+.Bd -literal -offset indent
+The
+\&.Nm
+driver supports the following $device_class:
+.Ed
+.Pp
+Followed by the list of supported hardware.
+.Pp
+This defines what driver the subsection is referring to,
+and allows the reader to search through the Hardware Notes
+not only for the device models they have,
+but also for the device type they are looking to acquire.
+.It
+The supported hardware should be listed as a bullet list,
+or if complexity requires, a column list.
+These two list types create very neat subsections
+with clean starting and stopping points.
+.El
 .Ss EXAMPLES Section
 .Bl -dash -width ""
 .It
diff --git a/share/man/man7/hier.7 b/share/man/man7/hier.7
index 949b521ab3d9..c5fb3cf0a7fb 100644
--- a/share/man/man7/hier.7
+++ b/share/man/man7/hier.7
@@ -156,6 +156,8 @@ file descriptor files; see
 .Xr fd 4
 .It Pa fd0
 first floppy drive
+.It Pa gpt/
+filesystems by GPT label
 .It Pa mmcsd0
 first SD storage device
 .It Pa mmcsd0s1
@@ -168,7 +170,7 @@ infinite loop that accepts anything and contains nothing
 .It Pa nvd0
 first NVMe storage device using NVMe namespaces
 .It Pa pts/
-pseduo-terminals; see
+pseudo-terminals; see
 .Xr pts 4
 .It Pa random
 source of weak randomness; see
diff --git a/share/man/man7/ports.7 b/share/man/man7/ports.7
index 1e924b291608..b681a326f407 100644
--- a/share/man/man7/ports.7
+++ b/share/man/man7/ports.7
@@ -1,4 +1,6 @@
 .\"
+.\" SPDX-License-Identifier: BSD-2-Clause
+.\"
 .\" Copyright (c) 1997 David E. O'Brien
 .\"
 .\" All rights reserved.
@@ -23,7 +25,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd September 24, 2023
+.Dd March 21, 2025
 .Dt PORTS 7
 .Os
 .Sh NAME
@@ -163,7 +165,7 @@ target.
 Configure
 .Va OPTIONS
 for this port using
-.Xr dialog4ports 1 .
+.Xr portconfig 1 Pq Pa ports/ports-mgmt/portconfig .
 .It Cm fetch
 Fetch all of the files needed to build this port from the sites
 listed in
@@ -245,7 +247,7 @@ configured.
 Configure
 .Va OPTIONS
 for this port and all its dependencies using
-.Xr dialog4ports 1 .
+.Xr portconfig 1 Pq Pa ports/ports-mgmt/portconfig .
 .It Cm fetch-list
 Show the list of files to fetch in order to build the port (but not its
 dependencies).