Make the SYNOPSIS section a bit more informative.

7 files changed, 91 insertions, 12 deletions

diff --git a/share/man/man4/snd_fm801.4 b/share/man/man4/snd_fm801.4
index b6b9b84c4721..0e6650451d56 100644
--- a/share/man/man4/snd_fm801.4
+++ b/share/man/man4/snd_fm801.4
@@ -24,15 +24,26 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd November 28, 2005
+.Dd December 1, 2005
 .Dt SND_FM801 4
 .Os
 .Sh NAME
 .Nm snd_fm801
 .Nd "Forte Media FM801 bridge device driver"
 .Sh SYNOPSIS
+To compile this driver into the kernel, place the following lines in your
+kernel configuration file:
+.Bd -ragged -offset indent
 .Cd "device sound"
 .Cd "device snd_fm801"
+.Ed
+.Pp
+Alternatively, to load the driver as a module at boot time, place the
+following line in
+.Xr loader.conf 5 :
+.Bd -literal -offset indent
+snd_fm801_load="YES"
+.Ed
 .Sh DESCRIPTION
 The
 .Nm
diff --git a/share/man/man4/snd_mss.4 b/share/man/man4/snd_mss.4
index 821fc831bcf6..76ef18339c6b 100644
--- a/share/man/man4/snd_mss.4
+++ b/share/man/man4/snd_mss.4
@@ -24,22 +24,35 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd November 28, 2005
+.Dd December 1, 2005
 .Dt SND_MSS 4
 .Os
 .Sh NAME
 .Nm snd_mss
 .Nd "Microsoft Sound System ISA PnP/non-PnP bridge device driver"
 .Sh SYNOPSIS
+To compile this driver into the kernel, place the following lines in your
+kernel configuration file:
+.Bd -ragged -offset indent
 .Cd "device sound"
 .Cd "device snd_mss"
+.Ed
+.Pp
+Alternatively, to load the driver as a module at boot time, place the
+following line in
+.Xr loader.conf 5 :
+.Bd -literal -offset indent
+snd_mss_load="YES"
+.Ed
 .Pp
 Non-PnP cards require the following lines in
-.Pa /boot/device.hints :
-.Cd hint.pcm.0.at="isa"
-.Cd hint.pcm.0.irq="10"
-.Cd hint.pcm.0.drq="1"
-.Cd hint.pcm.0.flags="0x0"
+.Xr device.hints 5 :
+.Bd -literal -offset indent
+hint.pcm.0.at="isa"
+hint.pcm.0.irq="10"
+hint.pcm.0.drq="1"
+hint.pcm.0.flags="0x0"
+.Ed
 .Sh DESCRIPTION
 The
 .Nm
diff --git a/share/man/man4/snd_neomagic.4 b/share/man/man4/snd_neomagic.4
index 698843d720e8..430220c23152 100644
--- a/share/man/man4/snd_neomagic.4
+++ b/share/man/man4/snd_neomagic.4
@@ -24,15 +24,26 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd November 28, 2005
+.Dd December 1, 2005
 .Dt SND_NEOMAGIC 4
 .Os
 .Sh NAME
 .Nm snd_neomagic
 .Nd "NeoMagic 256AV/ZX bridge device driver"
 .Sh SYNOPSIS
+To compile this driver into the kernel, place the following lines in your
+kernel configuration file:
+.Bd -ragged -offset indent
 .Cd "device sound"
 .Cd "device snd_neomagic"
+.Ed
+.Pp
+Alternatively, to load the driver as a module at boot time, place the
+following line in
+.Xr loader.conf 5 :
+.Bd -literal -offset indent
+snd_neomagic_load="YES"
+.Ed
 .Sh DESCRIPTION
 The
 .Nm
diff --git a/share/man/man4/snd_t4dwave.4 b/share/man/man4/snd_t4dwave.4
index 33ee6a04fa1e..ef916659115f 100644
--- a/share/man/man4/snd_t4dwave.4
+++ b/share/man/man4/snd_t4dwave.4
@@ -24,15 +24,26 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd November 28, 2005
+.Dd December 1, 2005
 .Dt SND_T4DWAVE 4
 .Os
 .Sh NAME
 .Nm snd_t4dwave
 .Nd "Trident 4DWave bridge device driver"
 .Sh SYNOPSIS
+To compile this driver into the kernel, place the following lines in your
+kernel configuration file:
+.Bd -ragged -offset indent
 .Cd "device sound"
 .Cd "device snd_t4dwave"
+.Ed
+.Pp
+Alternatively, to load the driver as a module at boot time, place the
+following line in
+.Xr loader.conf 5 :
+.Bd -literal -offset indent
+snd_t4dwave_load="YES"
+.Ed
 .Sh DESCRIPTION
 The
 .Nm
diff --git a/share/man/man4/snd_via8233.4 b/share/man/man4/snd_via8233.4
index b8a90db825c5..987353c8c091 100644
--- a/share/man/man4/snd_via8233.4
+++ b/share/man/man4/snd_via8233.4
@@ -24,15 +24,26 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd November 28, 2005
+.Dd December 1, 2005
 .Dt SND_VIA8233 4
 .Os
 .Sh NAME
 .Nm snd_via8233
 .Nd "VIA Technologies VT8233 bridge device driver"
 .Sh SYNOPSIS
+To compile this driver into the kernel, place the following lines in your
+kernel configuration file:
+.Bd -ragged -offset indent
 .Cd "device sound"
 .Cd "device snd_via8233"
+.Ed
+.Pp
+Alternatively, to load the driver as a module at boot time, place the
+following line in
+.Xr loader.conf 5 :
+.Bd -literal -offset indent
+snd_via8233_load="YES"
+.Ed
 .Sh DESCRIPTION
 The
 .Nm
diff --git a/share/man/man4/snd_via82c686.4 b/share/man/man4/snd_via82c686.4
index 2c9000bbfd9d..183684ec1170 100644
--- a/share/man/man4/snd_via82c686.4
+++ b/share/man/man4/snd_via82c686.4
@@ -24,15 +24,26 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd November 28, 2005
+.Dd December 1, 2005
 .Dt SND_VIA82C686 4
 .Os
 .Sh NAME
 .Nm snd_via82c686
 .Nd "VIA Technologies 82C686A bridge device driver"
 .Sh SYNOPSIS
+To compile this driver into the kernel, place the following lines in your
+kernel configuration file:
+.Bd -ragged -offset indent
 .Cd "device sound"
 .Cd "device snd_via82c686"
+.Ed
+.Pp
+Alternatively, to load the driver as a module at boot time, place the
+following line in
+.Xr loader.conf 5 :
+.Bd -literal -offset indent
+snd_via82c686_load="YES"
+.Ed
 .Sh DESCRIPTION
 The
 .Nm
diff --git a/share/man/man4/snd_vibes.4 b/share/man/man4/snd_vibes.4
index 6b86fc055054..716a65cd299a 100644
--- a/share/man/man4/snd_vibes.4
+++ b/share/man/man4/snd_vibes.4
@@ -24,15 +24,26 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd November 28, 2005
+.Dd December 1, 2005
 .Dt SND_VIBES 4
 .Os
 .Sh NAME
 .Nm snd_vibes
 .Nd "S3 SonicVibes bridge device driver"
 .Sh SYNOPSIS
+To compile this driver into the kernel, place the following lines in your
+kernel configuration file:
+.Bd -ragged -offset indent
 .Cd "device sound"
 .Cd "device snd_vibes"
+.Ed
+.Pp
+Alternatively, to load the driver as a module at boot time, place the
+following line in
+.Xr loader.conf 5 :
+.Bd -literal -offset indent
+snd_vibes_load="YES"
+.Ed
 .Sh DESCRIPTION
 The
 .Nm