git: 71a0ea70234d - main - umcs.4: Describe better, canonicalize SYNOPSIS

The branch main has been updated by ziaee:

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

commit 71a0ea70234d58292bdf4b1dfad4f81511bd3457
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2026-09-21 20:59:21 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2026-09-21 21:03:20 +0000

    umcs.4: Describe better, canonicalize SYNOPSIS
    
    + tag SPDX
    + improve apropos and hardware notes context
    + canonicalize SYNOPSIS
    
    MFC after:      3 days
---
 share/man/man4/umcs.4 | 31 +++++++++++++------------------
 1 file changed, 13 insertions(+), 18 deletions(-)

diff --git a/share/man/man4/umcs.4 b/share/man/man4/umcs.4
index 0ed778066a6e..389783af77e8 100644
--- a/share/man/man4/umcs.4
+++ b/share/man/man4/umcs.4
@@ -1,4 +1,6 @@
 .\"
+.\" SPDX-License-Identifier: BSD-2-Clause
+.\"
 .\" Copyright (c) 2010 Lev Serebryakov <lev@FreeBSD.org>.
 .\" All rights reserved.
 .\"
@@ -26,33 +28,25 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd April 26, 2017
+.Dd September 21, 2026
 .Dt UMCS 4
 .Os
 .Sh NAME
 .Nm umcs
-.Nd USB support for serial adapters based on the MCS7820 and MCS7840 chips
+.Nd ASIX/MosChip MCS7840/MCS7820 USB to serial UART 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 usb"
-.Cd "device ucom"
-.Cd "device umcs"
-.Ed
+.Cd device usb
+.Cd device ucom
+.Cd device umcs
 .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
-umcs_load="YES"
-.Ed
+.Cd umcs_load="YES"
 .Sh DESCRIPTION
 The
 .Nm
-driver provides support for various multiport serial adapters based on the MosCom
-MCS7820 and MCS7840 chips.
+driver provides support for various multiport serial adapters
+based on the ASIX/MosChip MCS7840 and MCS7820 chips.
 They are 2- or 4-port adapters with full-featured
 16550-compatible UARTs and very flexible baud generators.
 Also, these chips
@@ -70,7 +64,8 @@ and
 .Sh HARDWARE
 The
 .Nm
-driver was tested on the following adapters:
+driver supports the following USB to serial UART controllers
+based on the ASIX/MosChip MCS7840 and MCS7820:
 .Pp
 .Bl -bullet -compact
 .It