[src/trunk]: src/share/man/man4 Use inline cross-references.

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

details:   https://anonhg.NetBSD.org/src/rev/822b09e993d4
branches:  trunk
changeset: 1019467:822b09e993d4
user:      nia <nia%NetBSD.org@localhost>
date:      Thu Mar 11 16:50:08 2021 +0000

description:
Use inline cross-references.

Remove dead references that mandoc complains about.

diffstat:

 share/man/man4/isa.4 |  207 +++++++++++++++-----------------------------------
 1 files changed, 63 insertions(+), 144 deletions(-)

diffs (truncated from 382 to 300 lines):

diff -r 14753caf8860 -r 822b09e993d4 share/man/man4/isa.4
--- a/share/man/man4/isa.4      Thu Mar 11 16:43:01 2021 +0000
+++ b/share/man/man4/isa.4      Thu Mar 11 16:50:08 2021 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: isa.4,v 1.47 2019/10/25 17:39:57 martin Exp $
+.\"    $NetBSD: isa.4,v 1.48 2021/03/11 16:50:08 nia Exp $
 .\"
 .\" Copyright (c) 1997 Jason R. Thorpe.  All rights reserved.
 .\" Copyright (c) 1997 Jonathan Stone
@@ -66,222 +66,212 @@
 drivers, sorted by device type and driver name:
 .Ss SCSI interfaces
 .Bl -tag -width pcdisplay -offset indent
-.It adv
+.It Xr adv 4
 Advansys
 .Tn SCSI
 interfaces.
-.It aha
+.It Xr aha 4
 Adaptec AHA-154x family (154xA, 154xB, 154xC, and 154xCF) and the
 BusLogic BT54x
 .Tn SCSI
 interfaces.
-.It ahc
+.It Xr ahc 4
 Adaptec 29xx, 39xx, and other AIC-7xxx-based
 .Tn SCSI
 interfaces.
-.It aic
+.It Xr aic 4
 Adaptec AIC-6260 and Adaptec AIC-6360 based
 .Tn SCSI
 interfaces, including
 the Adaptec 152x, SoundBlaster
 .Tn SCSI
 interfaces, and a variety of compatibles.
-.It bha
+.It Xr bha 4
 BusLogic BT-445
 .Tn SCSI
 interfaces.
-.It dpt
+.It Xr dpt 4
 DPT SmartCache/SmartRAID III and IV
 .Tn SCSI
 interfaces.
-.It esp
+.It Xr esp 4
 NCR 53C9x, Emulex ESP406, and Qlogic FAS408
 .Tn SCSI
 interfaces.
-.It nca
+.It Xr nca 4
 NCR-5380/NCR-53C400
-.It sea
+.It Xr sea 4
 Seagate/Future Domain
 .Tn SCSI
 cards.
 ST01/02, Future Domain TMC-885, and Future Domain TMC-950.
-.It uha
+.It Xr uha 4
 Ultrastor 14f
 .Tn SCSI
 interfaces.
-.It wds
+.It Xr wds 4
 WD-7000 family of bus-mastering
 .Tn SCSI
 interfaces.
 .El
 .Ss Disk and tape controllers
 .Bl -tag -width pcdisplay -offset indent
-.It mcd
+.It Xr mcd 4
 Mitsumi CD-ROM drives.
-.It wdc
+.It Xr wdc 4
 Standard Western Digital type hard drive controllers: MFM, RLL, ESDI,
 and IDE/ATAPI.
-.It wt
+.It Xr wt 4
 Wangtek and compatible QIC-02 and QIC-36 tape drives.
 .El
 .Ss Serial and parallel interfaces
 .Bl -tag -width pcdisplay -offset indent
-.It ast
+.It Xr ast 4
 Multi-port serial communications card first made by AST.
-.It boca
+.It Xr boca 4
 Boca BB100[48] and BB2016 multiplexing serial communications cards.
-.It com
+.It Xr com 4
 NS8250-, NS16450-, and NS16550-based serial ports.
-.It cy
+.It Xr cy 4
 Cyclades Cyclom-4Y, -8Y, and -16Y asynchronous serial communications cards.
 .It ioat
 .Tn BOCA Research
 IOAT66
 serial interfaces.
-.It lpt
+.It Xr lpt 4
 Standard
 .Tn ISA
 parallel port interface.
-.It rtfps
+.It Xr rtfps 4
 IBM RT four-port serial interfaces.
-.It tcom
+.It Xr tcom 4
 Byte Runner Technologies TC-400 and TC-800 series serial interfaces.
 .El
 .Ss Network interfaces
 .Bl -tag -width pcdisplay -offset indent
-.It ai
+.It Xr ai 4
 .Tn AT&T
 .Tn StarLan
 .Tn Ethernet
 interfaces.
-.It ate
+.It Xr ate 4
 Allied Telesis AT1700 series and RE2000 series
 .Tn Ethernet
 interfaces.
-.It cs
+.It Xr cs 4
 .Tn Cirrus Logic
 Crystal CS8900
 .Tn Ethernet
 interfaces.
-.It ec
+.It Xr ec 4
 3Com EtherLink II (3c503)
 .Tn Ethernet
 interfaces.
-.It ef
+.It Xr ef 4
 .Tn 3Com
 EtherLink II (3c507)
 .Tn Ethernet
 interfaces.
-.It eg
+.It Xr eg 4
 3Com EtherLink Plus (3c505)
 .Tn Ethernet
 interfaces.
-.It el
+.It Xr el 4
 3Com EtherLink (3c501)
 .Tn Ethernet
 interfaces.
-.It ep
+.It Xr ep 4
 3Com EtherLink III (3c509)
 .Tn Ethernet
 interfaces.
-.It fmv
+.It Xr fmv 4
 Fujitsu FMV-181 and FMV-182 interfaces.
-.\".It hp
-.\" Broken driver for HP -relabelled
-.\" .Tn Ethernet
-.\" cards.
-.It ix
+.It Xr ix 4
 Intel EtherExpress/16
 .Tn Ethernet
 interfaces.
-.It iy
+.It Xr iy 4
 Intel i82595-based
 .Tn Ethernet
 interfaces, including the EtherExpress Pro/10.
-.It lc
+.It Xr lc 4
 DEC EtherWORKS III
 .Tn Ethernet
 interfaces (DE203, DE204, and DE205).
-.It le
+.It Xr le 4
 .Tn Ethernet
 interfaces based on the AMD LANCE chip,
 including BICC Isolan, Novell NE2100, Digital DEPCA, and PCnet-ISA.
-.It ne
+.It Xr ne 4
 Novel NE2000 and compatible
 .Tn Ethernet
 interfaces.
-.It ntwoc
+.It Xr ntwoc 4
 SDL Communications Riscom/N2 synchronous serial interfaces.
-.It sm
+.It Xr sm 4
 SMC91C9x-based
 .Tn Ethernet
 interfaces.
-.It tr
-TROPIC based token ring interfaces.
-.It we
+.It Xr we 4
 Western Digital/SMC 80x3, SMC Elite Ultra, and SMC EtherEZ
 .Tn Ethernet
 interfaces.
 .El
 .Ss Sound cards and MIDI interfaces
 .Bl -tag -width pcdisplay -offset indent
-.It aria
+.It Xr aria 4
 Sierra's Aria based sound cards.
-.It cms
+.It Xr cms 4
 Creative Music System.
-.It ess
+.It Xr ess 4
 ESS Technology AudioDrive 1788-, 1888-, 1887-, and 888-based sound cards.
-.It gus
+.It Xr gus 4
 Gravis Ultrasound sound cards.
-.It mpu
+.It Xr mpu 4
 Roland MPU401 (and compatible) MIDI UARTs.
-.It opl
+.It Xr opl 4
 Yamaha OPL2 and OPL3 FM MIDI synthesizers.
-.It pas
+.It Xr pas 4
 ProAudio Spectrum sound cards.
-.It sb
+.It Xr sb 4
 SoundBlaster, SoundBlaster 16, and SoundBlaster Pro sound cards.
-.It wss
+.It Xr wss 4
 Windows Sound System-compatible sound cards based on the AD1848 and
 compatible chips.
 .El
 .Ss Miscellaneous devices
 .Bl -tag -width pcdisplay -offset indent
-.It az
+.It Xr az 4
 Aztech/PackardBell radio card.
-.It ega
-EGA graphics boards.
-.It lm
+.It Xr lm 4
 National Semiconductor LM78, LM79 and compatible hardware monitors.
-.It nct
+.It Xr nct 4
 Nuvoton NCT5104D SuperIO.
-.It pcdisplay
+.It Xr pcdisplay 4
 PC display adapters.
-.It pcic
+.It Xr pcic 4
 .Tn PCI
 .Tn PCMCIA
 controllers, including the Cirrus Logic GD6729.
-.It pckbc
+.It Xr pckbc 4
 PC keyboard controllers.
-.It pcppi
+.It Xr pcppi 4
 PC control and timer ports.
-.It pms
+.It Xr pms 4
 PS/2 auxiliary port mice (including wheel mice).
-.It rt
+.It Xr rt 4
 AIMS Lab Radiotrack FM radio.
-.It rtii
+.It Xr rtii 4
 AIMS Lab Radiotrack II FM radio.
-.It sf2r
+.It Xr sf2r 4
 SoundForte RadioLink SF16-FMR2 FM radio.
-.It soekrisgpio
-Soekris net6501 GPIO and LEDs driver
-.It tcic
+.It Xr tcic 4
 Databook DB86082, DB86084, DB86184, and DB86072
 .Tn PCMCIA
 controllers.
-.It vga
+.It Xr vga 4
 VGA graphics boards.
-.It wbsio
+.It Xr wbsio 4
 Winbond LPC Super I/O.
 .El
 .Pp
@@ -292,11 +282,6 @@
 Plug-and-Play variants.
 These are listed in
 .Xr isapnp 4 .
-Some i386 platforms use
-.Xr pnpbios 4
-to attach