try to actually (gasp!) describe the drivers.

sys/dev/eisa/files.eisa

@@ -1,4 +1,4 @@
-#	$NetBSD: files.eisa,v 1.1 1995/04/17 16:15:48 cgd Exp $
+#	$NetBSD: files.eisa,v 1.2 1995/04/17 17:54:15 cgd Exp $
 #
 # Config.new file and device description for machine-independent EISA code.
 # Included by ports that need it.  Requires that the SCSI files be
@@ -12,5 +12,6 @@
 #device	eisa at root {[slot = -1]}
 #file	dev/eisa/eisa.c			eisa
 
+# Adaptec AHA-174x EISA SCSI Host Adapter family
 device	ahb at isa: scsi		# XXX should be at EISA
 file	dev/eisa/aha1742.c	ahb     

sys/dev/isa/files.isa

@@ -1,4 +1,4 @@
-#	$NetBSD: files.isa,v 1.1 1995/04/17 16:58:30 cgd Exp $
+#	$NetBSD: files.isa,v 1.2 1995/04/17 17:54:30 cgd Exp $
 #
 # Config.new file and device description for machine-independent ISA code.
 # Included by ports that need it.  Requires that the SCSI files be
@@ -17,81 +17,168 @@
 #		     [irq = -1], [drq = -1]}
 file	dev/isa/isa.c			isa needs-flag
 
+# ISA DMA controller
 define	isadma
 file	dev/isa/isadma.c		isadma needs-flag
 
+#
+# 8250/16[45]50-based multi-port serial boards
+#
+
 define	commulti {[slave = -1]}
+
+# AST 4-port board
 device	ast at isa: commulti
 file	dev/isa/ast.c			ast
+
+# BOCA 8-port board
 device	boca at isa: commulti
 file	dev/isa/boca.c			boca
+
+# IBM RT PC 4-port board
 device	rtfps at isa: commulti
 file	dev/isa/rtfps.c			rtfps
 
+#
+# Serial and parallel drivers
+#
+
+# 8250/16[45]50-based "com" ports
 device	com at isa, commulti: tty
 file	dev/isa/com.c			com needs-count
-device	cy at isa: tty
-file	dev/isa/cy.c			cy needs-count
 
+# Cyclades Cyclom multiport serial cards
+# XXX currently broken
+#device	cy at isa: tty
+#file	dev/isa/cy.c			cy needs-count
+
+# PC parallel ports (XXX what chip?)
 device	lpt at isa
 file	dev/isa/lpt.c			lpt needs-flag
 
+#
+# SCSI host adapters
+#
+
+# Adaptec AHA-154x family
 device	aha at isa: scsi, isadma
 file	dev/isa/aha1542.c		aha
+
+# Adapctec AIC-6[32]60 ICs
 device	aic at isa: scsi, isadma
 file	dev/isa/aic6360.c		aic
+
+# BusLogic BT-74x EISA family (XXX; should be EISA.  it's special)
 device	bt at isa: scsi, isadma
 file	dev/isa/bt742a.c		bt
+
+# Seagate ST0[12] ICs
 device	sea at isa: scsi, isadma
 file	dev/isa/seagate.c		sea
+
+# UltraStor UHA-[13]4f boards
 device	uha at isa: scsi, isadma
 file	dev/isa/ultra14f.c		uha
+
+# Western Digital WD7000 boards (XXX incomplete description)
+# XXX not yet working
 device	wds at isa: scsi, isadma
 file	dev/isa/wd7000.c		wds
 
+#
+# Other ISA disk controllers
+#
+
+# Mitsumi CD-ROM controller
 device	mcd at isa: disk
 file	dev/isa/mcd.c			mcd needs-flag
-device	scd at isa: disk
-file	dev/isa/t/scd.c			scd needs-flag
+
+# XXX ???
+# XXX NOT IN TREE?
+#device	scd at isa: disk
+#file	dev/isa/t/scd.c			scd needs-flag
+
+# ISA "wd" (ESDI/IDE/etc.) controllers
 device	wdc at isa {drive = -1}
 device	wd at wdc: disk, isadma
 file	dev/isa/wd.c			wdc needs-flag
+
+# Wangtek- and Archive-compatible tape controller boards
 device	wt at isa: tape, isadma
 file	dev/isa/wt.c			wt needs-flag
 
+#
+# ISA networking drivers
+#
+
+# 3Com common probe code
 define	elink
 file	dev/isa/elink.c			elink
 
+# National Semiconductor DS8390/WD83C690-based boards
+# (WD/SMC 80x3 family, SMC Ultra [8216], 3Com 3C503, NE[12]000, and clones)
 device	ed at isa: ether, ifnet
 file	dev/isa/if_ed.c			ed
+
+# 3Com 3C505
 device	eg at isa: ether, ifnet
 file	dev/isa/if_eg.c			eg
+
+# 3Com 3C501
 device	el at isa: ether, ifnet
 file	dev/isa/if_el.c			el
+
+# 3Com 3C5x9 (EtherLink III) family
 device	ep at isa: ether, ifnet, elink
 file	dev/isa/if_ep.c			ep
+
+# HP Lan Ethernet controllers
+# XXX currently broken
 #device hp at isa: ether, ifnet
 #file	dev/isa/if_hp.c			hp
+
+# Intel i82586-based boards
+# (AT&T StarLAN 10, AT&T EN100, AT&T StarLAN Fiber, 3Com 3C507)
 device	ie at isa: ether, ifnet, elink
 file	dev/isa/if_ie.c			ie
-device	ix at isa: ether, ifnet
-file	dev/isa/if_ix.c			ix
+
+# XXX ???
+# XXX NOT IN TREE?
+#device	ix at isa: ether, ifnet
+#file	dev/isa/if_ix.c			ix
+
+# AMD am7990 (Lance) -based boards
+# (BICC Isolan, NE2100, DEPCA)
 device	le at isa: ether, ifnet, isadma
 file	dev/isa/if_le.c			le
 
+#
+# ISA Sound hardware
+#
+
+# the SoundBlaster DSP, or close likenesses; used by other drivers
 define	sbdsp
 file	dev/isa/sbdsp.c			sbdsp
+
+# SoundBlaster family
 device	sb at isa: audio, isadma, sbdsp
 file	dev/isa/sb.c			sb needs-flag
+
+# ProAudio Spectrum
 device	pas at isa: audio, isadma, sbdsp
 file	dev/isa/pas.c			pas needs-flag
 
+# ad1848 (XXX what is it?) chip spport; used by other drivers
 define	ad1848
 file	dev/isa/ad1848.c		ad1848
+
+# (XXX what is this?)
 device	pss at isa {[port = -1], [size = 0],
 		    [iomem = -1], [iosiz = 0],
 		    [irq = -1], [drq = -1]}
 device	sp at pss: audio, isadma, ad1848
 file	dev/isa/pss.c			pss needs-flag
+
+# Microsoft Windows Sound System
 device	wss at isa: audio, isadma, ad1848
 file	dev/isa/wss.c			wss needs-flag

sys/dev/pci/files.pci

@@ -1,4 +1,4 @@
-#	$NetBSD: files.pci,v 1.1 1995/04/17 07:46:10 cgd Exp $
+#	$NetBSD: files.pci,v 1.2 1995/04/17 17:54:35 cgd Exp $
 #
 # Config.new file and device description for machine-independent PCI code.
 # Included by ports that need it.  Requires that the SCSI files be
@@ -10,8 +10,11 @@
 #device	pci at root {[bus = -1], [dev = -1]}
 file	dev/pci/pci.c			pci
 
+# NCR 53C8{10,15,25} SCSI chips
 device	ncr at pci: scsi
 file	dev/pci/ncr.c			ncr
 
-device	de at pci: ether, ifnet
-file	dev/pci/if_de.c			de
+# XXX ???
+# XXX NOT IN TREE?
+#device	de at pci: ether, ifnet
+#file	dev/pci/if_de.c			de