Update man pages in the section 4 to match the reality in -CURRENT.

- Change lines referring to kernel configuration file:
        device foo0 at isa port xxx irq yyy...
  to
        device foo
  Describe resource "hints" in /boot/device.hints.

- Try to describe resource allocation and probe/attach behavior in the
  newbus framework.

1 files changed, 50 insertions, 13 deletions

diff --git a/share/man/man4/sio.4 b/share/man/man4/sio.4
index b6109d5303d5..ba0b2b2d5efb 100644
--- a/share/man/man4/sio.4
+++ b/share/man/man4/sio.4
@@ -44,34 +44,71 @@
 .Nd "fast interrupt driven asynchronous serial communications interface"
 .Sh SYNOPSIS
 For standard ISA ports:
-.Cd "device sio0 at isa? port IO_COM1 irq 4"
-.Cd "device sio1 at isa? port IO_COM2 irq 3"
-.Cd "device sio2 at isa? port IO_COM3 irq 5"
-.Cd "device sio3 at isa? port IO_COM4 irq 9"
+.Cd "device sio"
+.Pp
+In
+.Pa /boot/device.hints :
+.Cd hint.sio.0.at="isa"
+.Cd hint.sio.0.port="0x3f8"
+.Cd hint.sio.0.flags="0x10"
+.Cd hint.sio.0.irq="4"
+.Cd hint.sio.1.at="isa"
+.Cd hint.sio.1.port="0x2f8"
+.Cd hint.sio.1.flags="0x0"
+.Cd hint.sio.1.irq="3"
 .Pp
 For AST compatible multiport cards with 4 ports:
 .Cd "options COM_MULTIPORT"
-.Cd "device sio4 at isa? port 0x2a0 flags 0x701"
-.Cd "device sio5 at isa? port 0x2a8 flags 0x701"
-.Cd "device sio6 at isa? port 0x2b0 flags 0x701"
-.Cd "device sio7 at isa? port 0x2b8 flags 0x701 irq 12"
+.Cd "device sio"
+.Pp
+The lines in
+.Pa /boot/device.hints
+should be:
+.Cd hint.sio.4.at="isa"
+.Cd hint.sio.4.port="0x2a0"
+.Cd hint.sio.4.flags="0x701"
+.Cd hint.sio.5.at="isa"
+.Cd hint.sio.5.port="0x2a8"
+.Cd hint.sio.5.flags="0x701"
+.Cd hint.sio.6.at="isa"
+.Cd hint.sio.6.port="0x2b0"
+.Cd hint.sio.6.flags="0x701"
+.Cd hint.sio.7.at="isa"
+.Cd hint.sio.7.port="0x2b8"
+.Cd hint.sio.7.flags="0x701"
+.Cd hint.sio.7.irq="12"
 .Pp
 For Boca Board compatible multiport cards with 8 ports:
 .Cd "options COM_MULTIPORT"
-.Cd "device sio4 at isa? port 0x100 flags 0xb05"
+.Cd "device sio"
+.Pp
+In
+.Pa /boot/device.hints :
+.Cd hint.sio.4.at="isa"
+.Cd hint.sio.4.port="0x100"
+.Cd hint.sio.4.flags="0xb05"
 .Cd "..."
-.Cd "device sio11 at isa? port 0x138 flags 0xb05 irq 12"
+.Cd hint.sio.11.at="isa"
+.Cd hint.sio.11.port="0x138"
+.Cd hint.sio.11.flags="0xb05"
+.Cd hint.sio.11.irq="12"
 .Pp
 For Hayes ESP cards:
 .Cd "options COM_ESP"
+.Cd "device sio"
 .Cd "..."
 .Pp
-For PCI and PCCARD cards:
+For PCI and PCCARD cards, nolines are required in
+.Pa /boot/device.hints .
 .Cd "device sio"
 .Pp
 For dual port PCI cards that share an interrupt:
-.Cd "device sio2 at pci? flags 0x201"
-.Cd "device sio3 at pci? flags 0x201"
+.Cd "device sio"
+.Pp
+In
+.Pa /boot/device.hints :
+.Cd hint.sio.2.flags="0x201"
+.Cd hint.sio.3.flags="0x201"
 .Pp
 Meaning of
 .Ar flags :