git: eb8647387a - main - 14.2 Release HW Notes: cleanup keyboard/pointing

From: Alexander Ziaee <ziaee_at_FreeBSD.org>
Date: Sun, 09 Feb 2025 21:01:39 UTC
The branch main has been updated by ziaee:

URL: https://cgit.FreeBSD.org/doc/commit/?id=eb8647387aed2ccbee7aacfe27bf580080494445

commit eb8647387aed2ccbee7aacfe27bf580080494445
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2025-02-09 19:47:13 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2025-02-09 21:00:44 +0000

    14.2 Release HW Notes: cleanup keyboard/pointing
    
    For the Release HW Note template and 14.2:
    Move keyboards and pointing devices to the top of the Misc section.
    Remove inaccurate architecture limitation labels. Fill them in a bit,
    and note that human input devices are in Misc in the USB section,
    and clean those up a little.
    
    Looking at past HW release notes, these architecture limitation labels
    appear to come from 7.0R when all the different hardware architecture
    release notes were merged. Back then, this section said:
    [amd64, i386, ia64, pc98]. I assume ia64 and pc98 were dropped as they
    were dropped, and that is why amd64 and i386 remained.
    
    This commit removes FAX-Modem/PCCARD (requested by emaste).
    
    Reported by:            cperciva, emaste, mhorne, wulf
    Reported by:            Ronald Klop <ronald-lists@klop.ws>
    Accepted by:            mhorne (mentor)
    Differential Revision:  https://reviews.freebsd.org/D47699
---
 website/archetypes/release/hardware.adoc        | 61 +++++++++++++------------
 website/content/en/releases/14.2R/hardware.adoc | 61 +++++++++++++------------
 2 files changed, 66 insertions(+), 56 deletions(-)

diff --git a/website/archetypes/release/hardware.adoc b/website/archetypes/release/hardware.adoc
index 8c52c1eaca..1c90482953 100644
--- a/website/archetypes/release/hardware.adoc
+++ b/website/archetypes/release/hardware.adoc
@@ -723,17 +723,22 @@ Marvell 88W8363 IEEE 802.11n wireless network adapters (man:mwl[4] driver)
 [[usb]]
 === USB Devices
 
-[amd64, i386] A range of USB peripherals are supported; devices known to work are listed in this section.
+A range of USB peripherals are supported; devices known to work are listed in this section.
 Owing to the generic nature of most USB devices, with some exceptions any device of a given class will be supported, even if not explicitly listed here.
 
 [NOTE]
 ====
-[amd64, i386] USB Ethernet adapters can be found in the section listing <<ethernet,Ethernet interfaces>>.
+USB network interfaces can be found in <<ethernet,Ethernet Interfaces>> or <<wlan,Wireless Network Interfaces>>.
 ====
 
 [NOTE]
 ====
-[amd64, i386] USB Bluetooth adapters can be found in <<bluetooth,Bluetooth>> section.
+USB Bluetooth adapters can be found in <<bluetooth,Bluetooth>>.
+====
+
+[NOTE]
+====
+USB human interface devices can be found in <<misc,Miscellaneous>>.
 ====
 
 Altera University Program Secure Data Card IP Core (man:altera_sdcard[4] driver)
@@ -760,8 +765,6 @@ Altera University Program Secure Data Card IP Core (man:altera_sdcard[4] driver)
 
 [amd64, i386] Hubs
 
-[amd64, i386] Keyboards (man:ukbd[4] driver)
-
 [amd64, i386] Miscellaneous
 
 * Assist Computer Systems PC Camera C-M1
@@ -774,8 +777,6 @@ Altera University Program Secure Data Card IP Core (man:altera_sdcard[4] driver)
 
 &hwlist.umodem;
 
-[amd64, i386] Mice (man:ums[4] driver)
-
 &hwlist.rtsx;
 
 &hwlist.ulpt;
@@ -828,36 +829,40 @@ Altera University Program Secure Data Card IP Core (man:altera_sdcard[4] driver)
 [[misc]]
 === Miscellaneous
 
-[amd64, i386] FAX-Modem/PCCARD
-
-* MELCO IGM-PCM56K/IGM-PCM56KH
-* Nokia Card Phone 2.0 (gsm900/dcs1800 HSCSD terminal)
-
-[amd64, i386] Floppy drives (man:fdc[4] driver)
-
-[amd64, i386] VGA-compatible video cards (man:vga[4] driver)
+Keyboards including:
+
+* HID keyboards (man:hkbd[4] driver) over USB, I2C, or Apple SPI
+* USB keyboards (man:ukbd[4] driver)
+* PS/2 keyboards (man:atkbd[4] driver)
+* ADB keyboards (man:akbd[4] driver)
+* AT-style keyboards (man:atkbd[4] driver)
+* Hyper-v keyboards (**hv_kbd** driver)
+
+Pointing devices including:
+
+* HID mice (man:hms[4] driver) and touch devices (man:hmt[4] driver)
+over USB, I2C, Hyper-V, or Apple SPI
+* USB mice (man:ums[4] driver) and touch devices (man:wmt[4] driver)
+* Apple laptop trackpads (man:wsp[4] or man:apt[4] drivers)
+* Elantech I2C touchpads (man:ietp[4] driver)
+* Chromebook Cypress APA I2C touchpads (man:cyapa[4] driver)
+* PS/2 mice and compatible devices,
+including many laptop pointing devices (man:psm[4] driver)
+* ADB mice and touch devices (man:ams[4] driver)
+* Serial mice and compatible devices
 
 [NOTE]
 ====
-Information regarding specific video cards and compatibility with Xorg can be found at link:http://www.x.org/[http://www.x.org/].
+man:moused[8] has more information on using traditional pointing devices with the FreeBSD console.
 ====
 
-[amd64, i386] Keyboards including:
-
-* [i386] AT-style keyboards (man:atkbd[4] driver)
-* [amd64, i386] PS/2 keyboards (man:atkbd[4] driver)
-* [amd64, i386] USB keyboards (man:ukbd[4] driver)
-
-[amd64, i386] Pointing devices including:
+[amd64, i386] Floppy drives (man:fdc[4] driver)
 
-* [amd64, i386] PS/2 mice and compatible devices, including many laptop pointing devices (man:psm[4] driver)
-* Serial mice and compatible devices
-* [amd64, i386] USB mice (man:ums[4] driver)
+[amd64, i386] VGA-compatible video cards (man:vga[4] driver)
 
 [NOTE]
 ====
-man:moused[8] has more information on using pointing devices with FreeBSD.
-Information on using pointing devices with Xorg can be found at link:http://www.x.org/[http://www.x.org/].
+Information regarding specific video cards and compatibility with Xorg can be found at link:http://www.x.org/[http://www.x.org/].
 ====
 
 [amd64, i386] "PC standard" parallel ports (man:ppc[4] driver)
diff --git a/website/content/en/releases/14.2R/hardware.adoc b/website/content/en/releases/14.2R/hardware.adoc
index 8859570378..5665f2c3e9 100644
--- a/website/content/en/releases/14.2R/hardware.adoc
+++ b/website/content/en/releases/14.2R/hardware.adoc
@@ -3866,17 +3866,22 @@ driver supports audio devices based on the following chipset:
 [[usb]]
 === USB Devices
 
-[amd64, i386] A range of USB peripherals are supported; devices known to work are listed in this section.
+A range of USB peripherals are supported; devices known to work are listed in this section.
 Owing to the generic nature of most USB devices, with some exceptions any device of a given class will be supported, even if not explicitly listed here.
 
 [NOTE]
 ====
-[amd64, i386] USB Ethernet adapters can be found in the section listing <<ethernet,Ethernet interfaces>>.
+USB network interfaces can be found in <<ethernet,Ethernet Interfaces>> or <<wlan,Wireless Network Interfaces>>.
 ====
 
 [NOTE]
 ====
-[amd64, i386] USB Bluetooth adapters can be found in <<bluetooth,Bluetooth>> section.
+USB Bluetooth adapters can be found in <<bluetooth,Bluetooth>>.
+====
+
+[NOTE]
+====
+USB human interface devices can be found in <<misc,Miscellaneous>>.
 ====
 
 Altera University Program Secure Data Card IP Core (man:altera_sdcard[4] driver)
@@ -4014,8 +4019,6 @@ Most Windows CE based phones
 
 [amd64, i386] Hubs
 
-[amd64, i386] Keyboards (man:ukbd[4] driver)
-
 [amd64, i386] Miscellaneous
 
 * Assist Computer Systems PC Camera C-M1
@@ -4051,8 +4054,6 @@ driver include:
 *	Sonim XP5300 Force
 
 
-[amd64, i386] Mice (man:ums[4] driver)
-
 
 The
 **rtsx**
@@ -4475,36 +4476,40 @@ SafeNet 1741
 [[misc]]
 === Miscellaneous
 
-[amd64, i386] FAX-Modem/PCCARD
-
-* MELCO IGM-PCM56K/IGM-PCM56KH
-* Nokia Card Phone 2.0 (gsm900/dcs1800 HSCSD terminal)
-
-[amd64, i386] Floppy drives (man:fdc[4] driver)
-
-[amd64, i386] VGA-compatible video cards (man:vga[4] driver)
+Keyboards including:
+
+* HID keyboards (man:hkbd[4] driver) over USB, I2C, or Apple SPI
+* USB keyboards (man:ukbd[4] driver)
+* PS/2 keyboards (man:atkbd[4] driver)
+* ADB keyboards (man:akbd[4] driver)
+* AT-style keyboards (man:atkbd[4] driver)
+* Hyper-v keyboards (**hv_kbd** driver)
+
+Pointing devices including:
+
+* HID mice (man:hms[4] driver) and touch devices (man:hmt[4] driver)
+over USB, I2C, Hyper-V, or Apple SPI
+* USB mice (man:ums[4] driver) and touch devices (man:wmt[4] driver)
+* Apple laptop trackpads (man:wsp[4] or man:apt[4] drivers)
+* Elantech I2C touchpads (man:ietp[4] driver)
+* Chromebook Cypress APA I2C touchpads (man:cyapa[4] driver)
+* PS/2 mice and compatible devices,
+including many laptop pointing devices (man:psm[4] driver)
+* ADB mice and touch devices (man:ams[4] driver)
+* Serial mice and compatible devices
 
 [NOTE]
 ====
-Information regarding specific video cards and compatibility with Xorg can be found at link:http://www.x.org/[http://www.x.org/].
+man:moused[8] has more information on using traditional pointing devices with the FreeBSD console.
 ====
 
-[amd64, i386] Keyboards including:
-
-* [i386] AT-style keyboards (man:atkbd[4] driver)
-* [amd64, i386] PS/2 keyboards (man:atkbd[4] driver)
-* [amd64, i386] USB keyboards (man:ukbd[4] driver)
-
-[amd64, i386] Pointing devices including:
+[amd64, i386] Floppy drives (man:fdc[4] driver)
 
-* [amd64, i386] PS/2 mice and compatible devices, including many laptop pointing devices (man:psm[4] driver)
-* Serial mice and compatible devices
-* [amd64, i386] USB mice (man:ums[4] driver)
+[amd64, i386] VGA-compatible video cards (man:vga[4] driver)
 
 [NOTE]
 ====
-man:moused[8] has more information on using pointing devices with FreeBSD.
-Information on using pointing devices with Xorg can be found at link:http://www.x.org/[http://www.x.org/].
+Information regarding specific video cards and compatibility with Xorg can be found at link:http://www.x.org/[http://www.x.org/].
 ====
 
 [amd64, i386] "PC standard" parallel ports (man:ppc[4] driver)