Update sound-related manpages to account for the recent change in

device and module naming.  The following files were repo-copied:

	csa.4 -> snd_csa.4
	gusc.4 -> snd_gusc.4
	maestro3.4 -> snd_maestro3.4
	sbc.4 -> snd_sbc.4
	uaudio.4 -> snd_uaudio.4

The pcm(4) manpage wasn't renamed to sound(4) as there are nearby
plans to rename "device sound" to "device snd", to address the
ambiguity in naming, so pcm.4 is linked to sound.4 for the moment.
(We also mumble something about the future plans in the manpage.)

Removed links from pcm.4 to als4000.4 and emu10k1.4 -- they now
have their own snd_*.4 manpages.

Fixes for recent snd_*.4 manpages: added missing "device sound"
to the SYNOPSIS, fixed hints (they are still "hint.pcm.<unit>"
in most cases).

MT5 after:	3 days

1 files changed, 21 insertions, 8 deletions

diff --git a/share/man/man4/pcm.4 b/share/man/man4/pcm.4
index d89beb1..fbc5427 100644
--- a/share/man/man4/pcm.4
+++ b/share/man/man4/pcm.4
@@ -25,10 +25,11 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd June 24, 2004
-.Dt PCM 4
+.Dd August 28, 2004
+.Dt SOUND 4
 .Os
 .Sh NAME
+.Nm sound ,
 .Nm pcm ,
 .Nm snd
 .Nd
@@ -36,7 +37,7 @@
 PCM audio device infrastructure
 .Sh SYNOPSIS
 For a card with bridge driver support, and a PnP card:
-.Cd "device pcm"
+.Cd "device sound"
 .Pp
 For a card without bridge driver support, and a non-PnP card,
 the following lines may be required in
@@ -46,6 +47,16 @@ the following lines may be required in
 .Cd hint.pcm.0.drq="1"
 .Cd hint.pcm.0.flags="0x0"
 .Sh DESCRIPTION
+.Bf -emphasis
+Note: There exists some ambiguity in the naming at the moment
+.Pq Nm sound , pcm , snd .
+It will be resolved soon by renaming
+.Cd "device sound"
+to
+.Cd "device snd" ,
+and doing associated changes.
+.Ef
+.Pp
 The
 .Nm
 driver provides support for
@@ -109,7 +120,7 @@ in
 In general, the module
 .Pa snd_foo
 corresponds to
-.Cd "device foo"
+.Cd "device snd_foo"
 and can be
 loaded by the boot
 .Xr loader 8
@@ -338,6 +349,8 @@ The
 .Nm
 device driver first appeared in
 .Fx 2.2.6
+as
+.Nm pcm ,
 written by
 .An Luigi Rizzo .
 It was later
@@ -348,9 +361,9 @@ by
 The API evolved from the VOXWARE
 standard which later became OSS standard.
 .Sh SEE ALSO
-.Xr csa 4 ,
-.Xr gusc 4 ,
-.Xr sbc 4 ,
+.Xr snd_csa 4 ,
+.Xr snd_gusc 4 ,
+.Xr snd_sbc 4 ,
 .Xr devfs 5 ,
 .Xr loader.conf 5 ,
 .Xr dmesg 8 ,
@@ -364,7 +377,7 @@ standard which later became OSS standard.
 .An -nosplit
 .An Luigi Rizzo Aq luigi@iet.unipi.it
 initially wrote the
-.Nm
+.Nm pcm
 device driver and this manual page.
 .An Cameron Grant Aq gandalf@vilnya.demon.co.uk
 later revised the device driver for