[src/netbsd-9]: src/share/man/man4 Pull up following revision(s) (requested b...

[martin <martin%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/e4210eb69817
branches:  netbsd-9
changeset: 953867:e4210eb69817
user:      martin <martin%NetBSD.org@localhost>
date:      Mon Mar 22 17:15:16 2021 +0000

description:
Pull up following revision(s) (requested by nia in ticket #1232),
all via patch and adpated to netbsd-9:

        share/man/man4/pci.4: revision 1.111
        share/man/man4/pci.4: revision 1.112
        share/man/man4/pci.4: revision 1.113
        share/man/man4/pci.4: revision 1.114
        share/man/man4/pci.4: revision 1.115
        share/man/man4/pci.4: revision 1.116

add ena(4)
Put cross-references in a useful place, copying usb(4)
Caught a few drivers in the list that no longer exist this way.
Be less redundant in the DESCRIPTION
cross-reference pci(9)
add rtsx(4)
s/Disk and tape/Storage/g, more relevant cross-references

diffstat:

 share/man/man4/pci.4 |  529 ++++++++++++++++++--------------------------------
 1 files changed, 188 insertions(+), 341 deletions(-)

diffs (truncated from 624 to 300 lines):

diff -r 95cf979a0c46 -r e4210eb69817 share/man/man4/pci.4
--- a/share/man/man4/pci.4      Thu Mar 11 16:17:14 2021 +0000
+++ b/share/man/man4/pci.4      Mon Mar 22 17:15:16 2021 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: pci.4,v 1.100 2018/12/12 08:12:18 wiz Exp $
+.\"    $NetBSD: pci.4,v 1.100.2.1 2021/03/22 17:15:16 martin Exp $
 .\"
 .\" Copyright (c) 1997 Jason R. Thorpe.  All rights reserved.
 .\" Copyright (c) 1997 Jonathan Stone
@@ -29,7 +29,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 December 12, 2018
+.Dd March 12, 2021
 .Dt PCI 4
 .Os
 .Sh NAME
@@ -46,29 +46,12 @@
 .Cd options PCI_BUS_FIXUP
 .Cd options PCI_INTR_FIXUP
 .Sh DESCRIPTION
-Other
-.Nm
-attachments are machine-dependent and depend on the bus topology and
-.Tn PCI
-bus interface of your system.
-See
-.Xr intro 4
-for your system for details.
+.Nx
+includes a machine-independent PCI bus subsystem and several
+machine-independent PCI device drivers.
 .Pp
-.Nx
-includes a machine-independent
-.Tn PCI
-bus subsystem and
-several machine-independent
-.Tn PCI
-device drivers.
-.Pp
-Your system may support additional
-.Tn PCI
-devices.
-Drivers for
-.Tn PCI
-devices not listed here are machine-dependent.
+Your system may support additional PCI devices and attachments.
+Drivers for PCI devices not listed here are machine-dependent.
 Consult your system's
 .Xr intro 4
 for additional information.
@@ -133,284 +116,231 @@
 .El
 .Sh HARDWARE
 .Nx
-includes machine-independent
-.Tn PCI
-drivers, sorted by device type and driver name:
+includes machine-independent PCI drivers, sorted by device type and driver name:
 .Ss SCSI interfaces
-.Bl -tag -width pcdisplay -offset indent
-.It ahc
-Adaptec 29xx, 39xx, and other AIC-7xxx-based
-.Tn SCSI
-interfaces.
-.It adv
-Advansys
-.Tn SCSI
-interfaces.
-.It adw
-Advansys Ultra Wide
-.Tn SCSI
+.Bl -tag -width pcdisplay(4) -offset indent
+.It Xr ahc 4
+Adaptec 29xx, 39xx, and other AIC-7xxx-based SCSI
 interfaces.
-.It bha
-Buslogic BT-9xx
-.Tn SCSI
-interfaces.
-.It dpt
-DPT SmartCache/SmartRAID III and IV
-.Tn SCSI
-interfaces.
-.It iha
-Initio INIC-940/950
-.Tn SCSI
-interfaces.
-.It isp
-QLogic ISP-1020, ISP-1040, and ISP-2100
-.Tn SCSI
-and
-.Tn FibreChannel
-interfaces.
-.It mfi
+.It Xr adv 4
+Advansys SCSI interfaces.
+.It Xr adw 4
+Advansys Ultra Wide SCSI interfaces.
+.It Xr bha 4
+Buslogic BT-9xx SCSI interfaces.
+.It Xr dpt 4
+DPT SmartCache/SmartRAID III and IV SCSI interfaces.
+.It Xr iha 4
+Initio INIC-940/950 SCSI interfaces.
+.It Xr isp 4
+QLogic ISP-1020, ISP-1040, and ISP-2100 SCSI and FibreChannel interfaces.
+.It Xr mfi 4
 LSI Logic & Dell MegaRAID SAS RAID controllers.
-.It mly
+.It Xr mly 4
 Mylex AcceleRAID and eXtremeRAID controllers with v6 firmware.
-.It nca
-Domex 536
-.Tn SCSI
-interfaces.
-.It pcscp
-Advanced Micro Devices Am53c974 PCscsi-PCI
-.Tn SCSI
-interfaces.
-.It siop
-Symbios Logic/NCR 53c8xx-family
-.Tn SCSI
-interfaces.
-.It trm
-Tekram TRM-S1040 ASIC based
-.Tn SCSI
-interfaces.
+.It Xr nca 4
+Domex 536 SCSI interfaces.
+.It Xr pcscp 4
+Advanced Micro Devices Am53c974 PCscsi-PCI SCSI interfaces.
+.It Xr siop 4
+Symbios Logic/NCR 53c8xx-family SCSI interfaces.
+.It Xr trm 4
+Tekram TRM-S1040 ASIC based SCSI interfaces.
 .El
-.Ss Disk and tape controllers
-.Bl -tag -width pcdisplay -offset indent
-.It aac
+.Ss Storage controllers
+.Bl -tag -width pcdisplay(4) -offset indent
+.It Xr aac 4
 The Adaptec AAC family of RAID controllers.
-.It ahcisata
+.It Xr ahcisata 4
 AHCI 1.0 and 1.1 compliant SATA controllers.
-.It amr
+.It Xr amr 4
 The AMI and LSI Logic MegaRAID family of RAID controllers.
-.It cac
+.It Xr cac 4
 Compaq array controllers.
-.It icp
+.It Xr icp 4
 ICP Vortex GDT and Intel Storage RAID controllers.
-.It mlx
+.It Xr mlx 4
 Mylex DAC960 and DEC SWXCR RAID controllers.
-.It pciide
+.It Xr nvme 4
+Non-Volatile Memory (NVM Express) host controllers.
+.It Xr pciide 4
 IDE disk controllers.
-.It twe
+.It Xr rtsx 4
+Realtek SD card readers.
+.It Xr twe 4
 3Ware Escalade RAID controllers.
 .El
-.Ss Network interfaces
-.Bl -tag -width pcdisplay -offset indent
-.It an
-.Tn Aironet
-4500/4800 and
-.Tn Cisco
-340 series 802.11 interfaces.
-.It bnx
+.Ss Wired network interfaces
+.Bl -tag -width pcdisplay(4) -offset indent
+.It Xr aq 4
+Aquantia AQC multigigabit Ethernet interfaces.
+.It Xr bnx 4
 Broadcom NetXtreme II 10/100/1000 Ethernet interfaces.
-.It de
-.Tn DEC
-DC21x4x (Tulip) based
-.Tn Ethernet
-interfaces, including the DE435,
-DE450, and DE500, and Znyx, SMC, Cogent/Adaptec, and Asante single- and
-multi-port
-.Tn Ethernet
-interfaces.
-.It ep
-3Com 3c590, 3c595, 3c900, and 3c905
-.Tn Ethernet
-interfaces.
-.It epic
-SMC83C170 (EPIC/100)
-.Tn Ethernet
-interfaces.
-.It esh
-RoadRunner-based HIPPI interfaces.
-.It ex
-3Com 3c900, 3c905, and 3c980
-.Tn Ethernet
-interfaces.
-.It fpa
-.Tn DEC
-DEFPA
-.Tn FDDI
-interfaces.
-.It fxp
-Intel EtherExpress PRO 10+/100B
-.Tn Ethernet
-interfaces.
-.It gsip
-National Semiconductor DP83820 based Gigabit
-.Tn Ethernet
-interfaces.
-.It hme
-Sun Microelectronics STP2002-STQ
-.Tn Ethernet
-interfaces.
-.It le
-PCNet-PCI
-.Tn Ethernet
-interfaces.
+.It Xr ena 4
+Elastic Network Adapter interfaces.
+.It Xr ep 4
+3Com 3c590, 3c595, 3c900, and 3c905 Ethernet interfaces.
+.It Xr epic 4
+SMC83C170 (EPIC/100) Ethernet interfaces.
+.It Xr ex 4
+3Com 3c900, 3c905, and 3c980 Ethernet interfaces.
+.It Xr fxp 4
+Intel EtherExpress PRO 10+/100B Ethernet interfaces.
+.It Xr gsip 4
+National Semiconductor DP83820 based Gigabit Ethernet interfaces.
+.It Xr hme 4
+Sun Microelectronics STP2002-STQ Ethernet interfaces.
+.It Xr ixg 4
+Intel 82598EB, 82599, X540 and X550 10 Gigabit Ethernet interfaces.
+.It Xr le 4
+PCNet-PCI Ethernet interfaces.
 Note, the
 .Xr pcn 4
 driver supersedes this driver.
-.It msk
-Marvell Yukon 2 based Gigabit
-.Tn Ethernet
-interfaces.
-.It ne
-NE2000-compatible
-.Tn Ethernet
-interfaces.
-.It nfe
-NVIDIA nForce
-.Tn Ethernet
-interfaces.
-.It ntwoc
+.It Xr mcx 4
+Mellanox 5th generation Ethernet devices.
+.It Xr msk 4
+Marvell Yukon 2 based Gigabit Ethernet interfaces.
+.It Xr ne 4
+NE2000-compatible Ethernet interfaces.
+.It Xr nfe 4
+NVIDIA nForce Ethernet interfaces.
+.It Xr ntwoc 4
 SDL Communications N2pci and WAN/ic 400 synchronous serial interfaces.
-.It pcn
-AMD PCnet-PCI family of
-.Tn Ethernet
-interfaces.
-.It ral
-Ralink Technology RT2500/RT2600-based 802.11a/b/g wireless network interfaces.
-.It rtk
-Realtek 8129/8139 based
-.Tn Ethernet
-interfaces.
-.It rtwn
-Realtek RTL8188CE/RTL8192CE 802.11b/g/n wireless network interfaces.
-.It sf
-Adaptec AIC-6915 10/100
-.Tn Ethernet
-interfaces.
-.It sip
+.It Xr pcn 4
+AMD PCnet-PCI family of Ethernet interfaces.
+.It Xr re 4
+Realtek 10/100/1000 Ethernet adapters.
+.It Xr rtk 4
+Realtek 8129/8139 based Ethernet interfaces.
+.It Xr sf 4
+Adaptec AIC-6915 10/100 Ethernet interfaces.
+.It Xr sip 4