misc/39625: cardbus(9) CODE REFERENCES section is wrong

[Ephaeton%gmx.net@localhost]

>Number:         39625
>Category:       misc
>Synopsis:       cardbus(9) CODE REFERENCES section is wrong
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Wed Sep 24 22:30:00 +0000 2008
>Originator:     Martin S. Weber
>Release:        4.99.72/i386
>Organization:
>Environment:
NetBSD agamemnon.entropie.local 4.99.72 NetBSD 4.99.72 (AGAMEMNON) #4: Sat Sep 
20 20:45:58 EDT 2008  
root%agamemnon.entropie.local@localhost:/home/netbsd/obj/sys/arch/i386/compile/AGAMEMNON
 i386
>Description:
The "CODE REFERENCES" section of cardbus(9) is essentially copy-pasted from 
pcmcia(9) with an s/pcmcia/cardbus/ afterwards. That's wrong unfortunately. 
This part:

" The database of known devices exists within the file 
sys/dev/cardbus/cardbus_data.h and is generated automatically from the file 
sys/dev/cardbus/cardbusdevs.New vendor and product identifiers should be added 
to this file.  The database can be regenerated using the Makefile 
sys/dev/cardbus/Makefile.cardbusdevs."

references two non-existing files: sys/dev/cardbus/cardbusdevs does not exist, 
nor does Makefile.cardbusdevs. In fact you hook up new stuff the brutal way 
(found by trying to hack some new hardware in, still not yet successful :( )

>How-To-Repeat:
man 9 cardbus.
Try to actually do what CODE REFERENCES suggests.
>Fix:
Replace section CODE REFERENCES with valid data and usual procedure to add 
devices. As I was doing this with trial and error someone else most probably 
qualifies better to write a description for that.