should there be a manpage for every device? every kernel configuration interface attribute?

["Jeremy C. Reed" <reed%reedmedia.net@localhost>]

I often see names that don't have corresponding manual pages like "ra".

I think there should be a man page for every device.

I think there should be a man page for every kernel configuration 
interface attribute (I don't know if that is the right term, but I will 
show examples below.)

What do you think?

 m=`uname -m` ; dmesg |  egrep "^[^ ]+ at " |
 cut -d " " -f 1,3 | tr -d ":" | fmt 1 |
 sed -e 's,[0-9]$,,g' | sort -u | while read d ; do
  [ -e "/usr/share/man/man4/$d.4" ] ||
  [ -e "/usr/share/man/man4/$m/$d.4" ] || echo "$d needed" ; done

output on vax 4.0:

ibus needed
mscpbus needed
mtc needed
ra needed
rl needed
rlc needed
rx needed
uba needed

on amd64 HEAD:

cpu needed
hpet needed
ioapic needed
pcib needed

and on i386 3.1:

cpu needed
pcib needed


And another example:

cat /usr/src/sys/arch/i386/conf/GENERIC | tr -d '#' | egrep "^[^ ]+ at " | 
cut -d " " -f 1,3 | tr -d ":*?" | fmt 1 | sed -e 's,[0-9]$,,g' |
sort -u | while read d ; do
          [ -e "/usr/share/man/man4/$d.4" ] ||
          [ -e "/usr/share/man/man4/$m/$d.4" ] || echo "$d needed" ; done

results in:

addcom needed
adt7463c needed
amdpcib needed
cpu needed
elansc needed
gcscehci needed
gcscpcib needed
geodecntr needed
geodegcb needed
geodewdog needed
gscpcib needed
iic needed
ioapic needed
p64h2apic needed
root needed
satlink needed
stuirda needed
vald needed
viapcib needed
weasel needed




So should many of the above be documented or what?

I can make the beginning of webpages as needed.

  Jeremy C. Reed