Improved wording in the descriptions of hints. In particular, don't start

a new paragraph for describing the hints associated with each card type.

Reviewed by:	ru

3 files changed, 19 insertions, 20 deletions

diff --git a/share/man/man4/cy.4 b/share/man/man4/cy.4
index 265f0ad..44d0c7f 100644
--- a/share/man/man4/cy.4
+++ b/share/man/man4/cy.4
@@ -45,19 +45,20 @@
 .Nd Cyclades Cyclom-Y serial driver
 .Sh SYNOPSIS
 .Cd "options CY_PCI_FASTINTR"
-.Cd "device cy 1"
 .Pp
-In
+For one (PCI or ISA) card:
+.Cd "device cy 1"
+For one ISA card, in
 .Pa /boot/device.hints :
 .Cd hint.cy.0.at="isa"
 .Cd hint.cy.0.irq="10"
 .Cd hint.cy.0.maddr="0xd4000"
 .Cd hint.cy.0.msize="0x2000"
 .Pp
-If you have two cards:
-.Cd "options CY_PCI_FASTINTR"
+For two (PCI and/or ISA) cards:
 .Cd "device cy 2"
-.Pp
+For two ISA cards, in
+.Pa /boot/device.hints :
 .Cd hint.cy.0.at="isa"
 .Cd hint.cy.0.irq="10"
 .Cd hint.cy.0.maddr="0xd4000"
diff --git a/share/man/man4/man4.i386/cy.4 b/share/man/man4/man4.i386/cy.4
index 265f0ad..44d0c7f 100644
--- a/share/man/man4/man4.i386/cy.4
+++ b/share/man/man4/man4.i386/cy.4
@@ -45,19 +45,20 @@
 .Nd Cyclades Cyclom-Y serial driver
 .Sh SYNOPSIS
 .Cd "options CY_PCI_FASTINTR"
-.Cd "device cy 1"
 .Pp
-In
+For one (PCI or ISA) card:
+.Cd "device cy 1"
+For one ISA card, in
 .Pa /boot/device.hints :
 .Cd hint.cy.0.at="isa"
 .Cd hint.cy.0.irq="10"
 .Cd hint.cy.0.maddr="0xd4000"
 .Cd hint.cy.0.msize="0x2000"
 .Pp
-If you have two cards:
-.Cd "options CY_PCI_FASTINTR"
+For two (PCI and/or ISA) cards:
 .Cd "device cy 2"
-.Pp
+For two ISA cards, in
+.Pa /boot/device.hints :
 .Cd hint.cy.0.at="isa"
 .Cd hint.cy.0.irq="10"
 .Cd hint.cy.0.maddr="0xd4000"
diff --git a/share/man/man4/sio.4 b/share/man/man4/sio.4
index 0f8e710..724ec83 100644
--- a/share/man/man4/sio.4
+++ b/share/man/man4/sio.4
@@ -45,7 +45,6 @@
 .Sh SYNOPSIS
 For standard ISA ports:
 .Cd "device sio"
-.Pp
 In
 .Pa /boot/device.hints :
 .Cd hint.sio.0.at="isa"
@@ -60,10 +59,8 @@ In
 For AST compatible multiport cards with 4 ports:
 .Cd "options COM_MULTIPORT"
 .Cd "device sio"
-.Pp
-The lines in
-.Pa /boot/device.hints
-should be:
+In
+.Pa /boot/device.hints :
 .Cd hint.sio.4.at="isa"
 .Cd hint.sio.4.port="0x2a0"
 .Cd hint.sio.4.flags="0x701"
@@ -81,7 +78,6 @@ should be:
 For Boca Board compatible multiport cards with 8 ports:
 .Cd "options COM_MULTIPORT"
 .Cd "device sio"
-.Pp
 In
 .Pa /boot/device.hints :
 .Cd hint.sio.4.at="isa"
@@ -96,7 +92,6 @@ In
 For Netmos Nm9845 multiport cards with 6 ports:
 .Cd "options COM_MULTIPORT"
 .Cd "device sio"
-.Pp
 In
 .Pa /boot/device.hints :
 .Cd hint.sio.4.at="isa"
@@ -124,13 +119,15 @@ For Hayes ESP cards:
 .Cd "device sio"
 .Cd "..."
 .Pp
-For PCI and PCCARD cards, no lines are required in
-.Pa /boot/device.hints .
+For single port PCI and PCCARD cards:
 .Cd "device sio"
+No lines are required in
+.Pa /boot/device.hints
+for these cards.
 .Pp
 For dual port PCI cards that share an interrupt:
 .Cd "device sio"
-.Pp
+.Cd "options COM_MULTIPORT"
 In
 .Pa /boot/device.hints :
 .Cd hint.sio.2.flags="0x201"