git: 8f478e4ac62c - main - apple_bce.4: add a basic manpage describing the driver

The branch main has been updated by ngie:

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

commit 8f478e4ac62c7a4a2313d89dc59310aa74cf3f9b
Author:     Enji Cooper <ngie@FreeBSD.org>
AuthorDate: 2026-09-06 21:28:44 +0000
Commit:     Enji Cooper <ngie@FreeBSD.org>
CommitDate: 2026-09-14 02:33:57 +0000

    apple_bce.4: add a basic manpage describing the driver
    
    This new manpage describes what the apple_bce driver services, how the
    driver is configured, and what Apple models the driver claims to
    support.
    
    Reviewed by:    seuros
    Differential Revision:  https://reviews.freebsd.org/D59467
---
 share/man/man4/Makefile    |  5 +++++
 share/man/man4/apple_bce.4 | 53 ++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 58 insertions(+)

diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile
index 7a5ef9f397eb..c56a629bd5e6 100644
--- a/share/man/man4/Makefile
+++ b/share/man/man4/Makefile
@@ -53,6 +53,7 @@ MAN=	aac.4 \
 	${_amdsmn.4} \
 	${_amdsmu.4} \
 	${_amdtemp.4} \
+	${_apple_bce.4} \
 	${_bxe.4} \
 	${_aout.4} \
 	${_apic.4} \
@@ -971,6 +972,10 @@ MLINKS+=sume.4 if_sume.4
 _bhyve.4=	bhyve.4
 _vmm.4=		vmm.4
 .endif
+
+.if ${MK_USB} != "no"
+_apple_bce.4=	apple_bce.4
+.endif
 .endif
 
 .if ${MACHINE_CPUARCH} == "amd64" || ${MACHINE_CPUARCH} == "aarch64"
diff --git a/share/man/man4/apple_bce.4 b/share/man/man4/apple_bce.4
new file mode 100644
index 000000000000..2ebbc65a70a8
--- /dev/null
+++ b/share/man/man4/apple_bce.4
@@ -0,0 +1,53 @@
+.\"
+.\" Copyright (c) 2026 Enji Cooper <ngie@FreeBSD.org>
+.\"
+.\" SPDX-License-Identifier: BSD-2-Clause
+.\"
+.Dd September 6, 2026
+.Dt APPLE_BCE 4
+.Os
+.Sh NAME
+.Nm apple_bce
+.Nd Apple T2 Buffer Copy Engine driver
+.Sh SYNOPSIS
+.Cd device pci
+.Cd device usb
+.Cd device apple_bce
+.Sh DESCRIPTION
+The
+.Nm
+driver controls the Apple T2 Buffer Copy Engine.
+.Pp
+The T2 Buffer Copy Engine, called
+.Dq BCE
+for short, is a device which interacts with higher-level interfaces like the built-in
+keyboard, trackpad, audio, and VHCI (Virtual USB Host Interface), etc.
+.Sh HARDWARE
+The
+.Nm
+driver supports the Apple T2 Buffer Copy Engine on the following systems:
+.Pp
+.Bl -bullet -offset indent -compact
+.It
+MacBook Air (2018-2020)
+.It
+MacBook Pro (2018-2020)
+.It
+MacMini (2018)
+.It
+Mac Pro (2019 and later)
+.El
+.Sh SEE ALSO
+.Xr asmc 4 ,
+.Xr usb 4
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Fx 16.0 .
+.Sh AUTHORS
+.Nm
+was written by
+.An Abdelkader Boudih Aq Mt seuros@FreeBSD.org .
+This manpage was written by
+.An Enji Cooper Aq Mt ngie@FreeBSD.org .