puc(4) man page update?

[Alexey Shuvaev]

Hello!

I have got
puc0 at pci0:0:10:0:       class=0x078000 card=0x00121000 chip=0x98359710 rev=0x01 hdr=0x00
    vendor     = 'MosChip Semiconductors (Was: Netmos Technology)'
    device     = 'Nm9835 Parallel/Serial Port Adapter'
    class      = simple comms

In a nutshell I have the following proposals to review:

- I have spent few hours figuring out why serial interfaces
  covered by puc(4) do not come up at boot time. The issue was I tried
  to use kernel module instead of compiling puc(4) into the kernel.
  Will it be good to have explicit note about it in the man page?

- First time when I rebuilt the kernel I only added
  options COM_MULTIPORT, which is used inside sio(4). The puc(4) also states
  the serial ports are managed by sio(4). However it seems that serial
  ports are actually handled by uart(4). Is COM_MULTIPORT kernel option
  obsolete?

- The puc(4) man page states parallel ports are not supported yet.
  It seems thay did now.

More info about the system:

[wep4020] ~> uname -a
FreeBSD wep4020 8.0-CURRENT FreeBSD 8.0-CURRENT #1: Mon Jun 30 19:24:21 CEST 2008     root at wep4020:/usr/obj/usr/src/sys/MULTIPORT  i386

---from dmesg---
puc0: <NetMos NM9835 Dual UART and 1284 Printer port> port 0x7c00-0x7c07,0x8000-0x8007,0x8400-0x8407,0x8800-0x8807,0x8c00-0x8c07,0x9000-0x900f irq 7 at device 10.0 on pci0
puc0: [FILTER]
uart0: <Non-standard ns8250 class UART with FIFOs> on puc0
uart0: [FILTER]
uart1: <Non-standard ns8250 class UART with FIFOs> on puc0
uart1: [FILTER]
ppc0: <Parallel port> on puc0
ppc0: SMC-like chipset (ECP/EPP/PS2/NIBBLE) in COMPATIBLE mode
ppc0: FIFO with 16/16/12 bytes threshold
ppbus0: <Parallel port bus> on ppc0
plip0: cannot reserve interrupt, failed.
lpt0: <Printer> on ppbus0
lpt0: Polled port
ppi0: <Parallel I/O> on ppbus0

I have roughly tested the functionality of this parallel port throug
the ppi interface. It seems to work.

Attached is a draft of a patch to share/man/man4/puc.4 but maybe more
work is required (regarding COM_MULTIPORT and sio(4) man page...).

Alexey.