mdoc: move CAVEATS, BUGS and SECURITY CONSIDERATIONS sections to the

bottom of the manpages and order them consistently.

GNU groff doesn't care about the ordering, and doesn't even mention
CAVEATS and SECURITY CONSIDERATIONS as common sections and where to put
them.

Found by:	mdocml lint run
Reviewed by:	ru

7 files changed, 59 insertions, 59 deletions

diff --git a/share/man/man4/man4.i386/cs.4 b/share/man/man4/man4.i386/cs.4
index c1ee7ae..b7e0389 100644
--- a/share/man/man4/man4.i386/cs.4
+++ b/share/man/man4/man4.i386/cs.4
@@ -129,12 +129,6 @@ The parameters obtained via PnP were not accepted by the driver.
 The adapter
 may not function.
 .El
-.Sh CAVEATS
-The CS89x0 family of adapters have a very small RAM buffer (4K).
-This may
-cause problems with extremely high network loads or bursty network traffic.
-In particular, NFS operations should be limited to 1k read/write transactions
-in order to avoid overruns.
 .Sh SEE ALSO
 .Xr arp 4 ,
 .Xr netintro 4 ,
@@ -150,3 +144,9 @@ and
 .An Oleg Sharoiko .
 This manpage was written by
 .An Michael Smith .
+.Sh CAVEATS
+The CS89x0 family of adapters have a very small RAM buffer (4K).
+This may
+cause problems with extremely high network loads or bursty network traffic.
+In particular, NFS operations should be limited to 1k read/write transactions
+in order to avoid overruns.
diff --git a/share/man/man4/man4.i386/ie.4 b/share/man/man4/man4.i386/ie.4
index 17d24d2..2ef9d05 100644
--- a/share/man/man4/man4.i386/ie.4
+++ b/share/man/man4/man4.i386/ie.4
@@ -116,12 +116,6 @@ The card refused to respond correctly during configuration.
 .It "ie%d: individual address setup command failed"
 The programming of the Ethernet (MAC) address failed.
 .El
-.Sh CAVEATS
-The Racal Interlan NI5210 comes in variants with 8 and 16 kbytes of
-shared memory.
-It is strongly advisable to use the 16 kbyte variant.
-You can upgrade your 8 kbyte card to 16 kbyte by adding an additional
-RAM chip.
 .Sh SEE ALSO
 .Xr arp 4 ,
 .Xr netintro 4 ,
@@ -141,3 +135,9 @@ support was written by
 .An Charles M. Hannum .
 This manual page was written by
 .An Wilko C. Bulte .
+.Sh CAVEATS
+The Racal Interlan NI5210 comes in variants with 8 and 16 kbytes of
+shared memory.
+It is strongly advisable to use the 16 kbyte variant.
+You can upgrade your 8 kbyte card to 16 kbyte by adding an additional
+RAM chip.
diff --git a/share/man/man4/man4.i386/mse.4 b/share/man/man4/man4.i386/mse.4
index 7f83dcc..a5cb3f7 100644
--- a/share/man/man4/man4.i386/mse.4
+++ b/share/man/man4/man4.i386/mse.4
@@ -373,10 +373,6 @@ Define the
 .Nm
 driver at the secondary port address with the IRQ 4 and the acceleration
 factor of 3.
-.Sh CAVEATS
-Some bus mouse interface cards generate interrupts at the fixed report rate
-when enabled, whether or not the mouse state is changing.
-The others generate interrupts only when the state is changing.
 .Sh SEE ALSO
 .Xr ioctl 2 ,
 .Xr mouse 4 ,
@@ -384,3 +380,7 @@ The others generate interrupts only when the state is changing.
 .Xr sysmouse 4 ,
 .Xr moused 8
 .\".Sh HISTORY
+.Sh CAVEATS
+Some bus mouse interface cards generate interrupts at the fixed report rate
+when enabled, whether or not the mouse state is changing.
+The others generate interrupts only when the state is changing.
diff --git a/share/man/man4/man4.i386/pnp.4 b/share/man/man4/man4.i386/pnp.4
index 1c9a2cd..7c17b0e 100644
--- a/share/man/man4/man4.i386/pnp.4
+++ b/share/man/man4/man4.i386/pnp.4
@@ -48,17 +48,6 @@ If it cannot assign necessary resources to a PnP ISA device without
 causing conflict with other devices in the system,
 the device will not be activated and will be unavailable
 to programs.
-.Sh CAVEATS
-It is not possible to disable individual PnP ISA devices.
-The
-.Nm
-driver will find all devices conforming the PnP ISA specification
-and try to activate them all.
-.Pp
-There is no way to explicitly assign particular resource to
-the PnP ISA device.
-The resource assignment is fully automatic and there is
-no provision for manual override.
 .Sh SEE ALSO
 .Xr pnpbios 4
 .Sh STANDARDS
@@ -88,3 +77,14 @@ by
 .An Luigi Rizzo ,
 based on initial work done by
 .An Sujal Patel .
+.Sh CAVEATS
+It is not possible to disable individual PnP ISA devices.
+The
+.Nm
+driver will find all devices conforming the PnP ISA specification
+and try to activate them all.
+.Pp
+There is no way to explicitly assign particular resource to
+the PnP ISA device.
+The resource assignment is fully automatic and there is
+no provision for manual override.
diff --git a/share/man/man4/man4.i386/pnpbios.4 b/share/man/man4/man4.i386/pnpbios.4
index d8e7609..b386be2 100644
--- a/share/man/man4/man4.i386/pnpbios.4
+++ b/share/man/man4/man4.i386/pnpbios.4
@@ -44,17 +44,6 @@ If it cannot assign necessary resources to a device without
 causing conflict with other devices in the system,
 the device will not be activated and will be unavailable
 to programs.
-.Sh CAVEATS
-There is no explicit way to disable individual embedded devices.
-The
-.Nm
-driver will find all devices reported by the
-.Dq "Plug and Play (PnP)"
-BIOS and try to activate them all.
-.Pp
-There is no way to explicitly assign particular resource to a device.
-The resource assignment is fully automatic and there is
-no provision for manual override.
 .Sh SEE ALSO
 .Xr pnp 4
 .Sh STANDARDS
@@ -83,3 +72,14 @@ The
 .Nm
 driver was written by
 .An Mike Smith .
+.Sh CAVEATS
+There is no explicit way to disable individual embedded devices.
+The
+.Nm
+driver will find all devices reported by the
+.Dq "Plug and Play (PnP)"
+BIOS and try to activate them all.
+.Pp
+There is no way to explicitly assign particular resource to a device.
+The resource assignment is fully automatic and there is
+no provision for manual override.
diff --git a/share/man/man4/man4.i386/vx.4 b/share/man/man4/man4.i386/vx.4
index 99d89e9..ab0472b 100644
--- a/share/man/man4/man4.i386/vx.4
+++ b/share/man/man4/man4.i386/vx.4
@@ -96,16 +96,6 @@ rebuild the kernel, and reboot.
 .Pp
 All other diagnostics indicate either a hardware problem or a bug in the
 driver.
-.Sh CAVEATS
-Some early-revision 3c590 cards are defective and suffer from many receive
-overruns, which cause lost packets.
-The author has attempted to implement
-a test for it based on the information supplied by 3Com, but the test resulted
-mostly in spurious warnings.
-.Pp
-The performance of this driver is somewhat limited by the fact that it uses
-only polled-mode I/O and does not make use of the bus-mastering capability
-of the cards.
 .Sh SEE ALSO
 .Xr arp 4 ,
 .Xr netintro 4 ,
@@ -128,6 +118,16 @@ device driver and this manual page were written by
 based on the work of
 .An Herb Peyerl
 and with the assistance of numerous others.
+.Sh CAVEATS
+Some early-revision 3c590 cards are defective and suffer from many receive
+overruns, which cause lost packets.
+The author has attempted to implement
+a test for it based on the information supplied by 3Com, but the test resulted
+mostly in spurious warnings.
+.Pp
+The performance of this driver is somewhat limited by the fact that it uses
+only polled-mode I/O and does not make use of the bus-mastering capability
+of the cards.
 .Sh BUGS
 The
 .Nm
diff --git a/share/man/man4/man4.i386/wl.4 b/share/man/man4/man4.i386/wl.4
index 2f8fdc5..a1eacda 100644
--- a/share/man/man4/man4.i386/wl.4
+++ b/share/man/man4/man4.i386/wl.4
@@ -141,17 +141,6 @@ packets and also stores the IP src address.
 ARP packets are ignored,
 as are any other network protocol barring IPv4 packets.
 .El
-.Sh CAVEATS
-The 82586 has numerous defects.
-It may experience transmit-side
-errors when modern faster cpus send packets at it faster than it can handle.
-The driver (and probably the chip) does not support an all multicast mode.
-As a result, it can be used with applications like
-.Xr mrouted 8 Pq Pa ports/net/mrouted ,
-but it must go into promiscuous mode for that to work.
-The driver
-is slow to change modes from "normal" to promiscuous mode, presumably
-due to delays in the configuration code.
 .Sh SEE ALSO
 .Xr sysctl 8 ,
 .Xr wlconfig 8
@@ -189,3 +178,14 @@ for contributions.
 .Sh AUTHORS
 Too numerous to mention.
 See above.
+.Sh CAVEATS
+The 82586 has numerous defects.
+It may experience transmit-side
+errors when modern faster cpus send packets at it faster than it can handle.
+The driver (and probably the chip) does not support an all multicast mode.
+As a result, it can be used with applications like
+.Xr mrouted 8 Pq Pa ports/net/mrouted ,
+but it must go into promiscuous mode for that to work.
+The driver
+is slow to change modes from "normal" to promiscuous mode, presumably
+due to delays in the configuration code.