git: f7550ef0e196 - stable/15 - game controller manuals: Canonicalize SYNOPSIS

From: Alexander Ziaee <ziaee_at_FreeBSD.org>
Date: Wed, 16 Sep 2026 12:05:11 UTC
The branch stable/15 has been updated by ziaee:

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

commit f7550ef0e196d20ac1b4f39d810d016444c633e2
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2026-09-11 10:04:08 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2026-09-16 12:03:48 +0000

    game controller manuals: Canonicalize SYNOPSIS
    
    While here, tag SPDX.
    
    Event:                  EuroBSDcon Devsummit 2026
    MFC after:              3 days
    Reviewed by:            wulf
    Differential Revision:  https://reviews.freebsd.org/D59256
    
    (cherry picked from commit b7541acacb662436591277977317072a4eaa6dc3)
---
 share/man/man4/hgame.4     | 12 +++++++-----
 share/man/man4/ps4dshock.4 | 39 +++++++++++++++++++++++----------------
 share/man/man4/xb360gp.4   | 36 +++++++++++++++++++-----------------
 3 files changed, 49 insertions(+), 38 deletions(-)

diff --git a/share/man/man4/hgame.4 b/share/man/man4/hgame.4
index b662a07993ac..fce60cd39e44 100644
--- a/share/man/man4/hgame.4
+++ b/share/man/man4/hgame.4
@@ -38,13 +38,15 @@
 .Cd device evdev
 .Pp
 In
-.Xr sysctl.conf 5 :
-.Cd dev.hgame.X.debug
-.Pp
-In
 .Xr loader.conf 5 :
 .Cd hw.hid.hgame.debug
-.Cd hgame_load
+.Cd hgame_load="YES"
+.Pp
+In
+.Xr loader.conf 5
+or
+.Xr sysctl.conf 5 :
+.Cd dev.hgame.X.debug
 .Sh DESCRIPTION
 The
 .Nm
diff --git a/share/man/man4/ps4dshock.4 b/share/man/man4/ps4dshock.4
index f48e2c07c1b7..bd1ee39f379d 100644
--- a/share/man/man4/ps4dshock.4
+++ b/share/man/man4/ps4dshock.4
@@ -1,3 +1,6 @@
+.\"
+.\" SPDX-License-Identifier: BSD-2-Clause
+.\"
 .\" Copyright (c) 2020 Vladimir Kondratyev <wulf@FreeBSD.org>
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -21,30 +24,34 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd November 30, 2025
+.Dd August 28, 2026
 .Dt PS4DSHOCK 4
 .Os
 .Sh NAME
 .Nm ps4dshock
 .Nd Sony PlayStation 4 Dualshock 4 gamepad driver
 .Sh SYNOPSIS
-To compile this driver into the kernel,
-place the following lines in your
-kernel configuration file:
-.Bd -ragged -offset indent
-.Cd "device ps4dshock"
-.Cd "device hid"
-.Cd "device hidbus"
-.Cd "device hidmap"
-.Cd "device evdev"
-.Ed
+.Cd device ps4dshock
+.Cd device hid
+.Cd device hidbus
+.Cd device hidmap
+.Cd device evdev
 .Pp
-Alternatively, to load the driver as a
-module at boot time, place the following line in
+In
 .Xr loader.conf 5 :
-.Bd -literal -offset indent
-ps4dshock_load="YES"
-.Ed
+.Cd hw.hid.ps4dshock.debug
+.Cd ps4dshock_load="YES"
+.Pp
+In
+.Xr loader.conf 5
+or
+.Xr sysctl.conf 5 :
+.Cd dev.p4dshock.*.led_state
+.Cd dev.p4dshock.*.led_color_r
+.Cd dev.p4dshock.*.led_color_g
+.Cd dev.p4dshock.*.led_color_b
+.Cd dev.p4dshock.*.led_delay_on
+.Cd dev.p4dshock.*.led_delay_off
 .Sh DESCRIPTION
 The
 .Nm
diff --git a/share/man/man4/xb360gp.4 b/share/man/man4/xb360gp.4
index 1ff42e970858..d012760cd3ed 100644
--- a/share/man/man4/xb360gp.4
+++ b/share/man/man4/xb360gp.4
@@ -1,3 +1,6 @@
+.\"
+.\" SPDX-License-Identifier: BSD-2-Clause
+.\"
 .\" Copyright (c) 2020 Vladimir Kondratyev <wulf@FreeBSD.org>
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -21,31 +24,30 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd November 30, 2025
+.Dd August 28, 2026
 .Dt XB360GP 4
 .Os
 .Sh NAME
 .Nm xb360gp
 .Nd XBox 360 gamepad driver
 .Sh SYNOPSIS
-To compile this driver into the kernel,
-place the following lines in your
-kernel configuration file:
-.Bd -ragged -offset indent
-.Cd "device xb360gp"
-.Cd "device hgame"
-.Cd "device hid"
-.Cd "device hidbus"
-.Cd "device hidmap"
-.Cd "device evdev"
-.Ed
+.Cd device xb360gp
+.Cd device hgame
+.Cd device hid
+.Cd device hidbus
+.Cd device hidmap
+.Cd device evdev
 .Pp
-Alternatively, to load the driver as a
-module at boot time, place the following line in
+In
 .Xr loader.conf 5 :
-.Bd -literal -offset indent
-xb360gp_load="YES"
-.Ed
+.Cd hw.hid.xb360gp.debug
+.Cd xb360gp_load="YES"
+.Pp
+In
+.Xr loader.conf 5
+or
+.Xr sysctl.conf 5 :
+.Cd dev.xb360gp.X.debug
 .Sh DESCRIPTION
 The
 .Nm