Rework the FILES section to cover the list of common symbolic links

in the /dev directory.  Also cover this driver's quirky relationship
with the MAKEDEV script.

1 files changed, 53 insertions, 12 deletions

diff --git a/share/man/man4/pcm.4 b/share/man/man4/pcm.4
index 32865e5..9387b07 100644
--- a/share/man/man4/pcm.4
+++ b/share/man/man4/pcm.4
@@ -124,19 +124,60 @@ Creative Labs SoundBlaster PCI is supported as well.
 .Pp
 .El
 .Sh FILES
-.Bl -tag -width /dev/snd* -compact
-.It Pa /dev/snd*
-Device nodes created with the shell commands
-.Bk -words
-.Ql cd /dev; sh MAKEDEV snd0
-.Ek
-for the pcm0 device,
-.Bk -words
-.Ql cd /dev; sh MAKEDEV snd1
-.Ek
-for the pcm1 device,
-etc.
+The following commonly used symbolic links to real device nodes
+should be present:
+.Pp
+.Bl -tag -width /dev/sequencer -compact
+.It Pa /dev/audio
+Sparc-compatible audio device
+.It Pa /dev/dsp
+Digitized voice device
+.It Pa /dev/dspW
+Like
+.Pa /dev/dsp ,
+but 16 bits per sample
+.It Pa /dev/midi
+Raw midi access device
+.It Pa /dev/mixer
+Control port mixer device
+.It Pa /dev/music
+Level 2 sequencer interface
+.It Pa /dev/sequencer
+Sequencer device
+.It Pa /dev/pss
+Programmable device interface
 .El
+.Pp
+Each symbolic link refers to a device node of the same name,
+but with a unit number appended.
+The unit number for each device matches the unit number of the
+device probed at boot time.
+Device probe messages can be examined with the
+.Xr dmesg 8
+utility.
+.Pp
+All the appropriate device nodes and symbolic links
+for the
+.Ql pcm0
+device would created with the following commands:
+.Bd -literal -offset indent
+cd /dev; sh MAKEDEV snd0
+.Ed
+.Pp
+Similarly, the device nodes and symbolic links for the
+.Ql pcm1
+device would be created as follows:
+.Bd -literal -offset indent
+cd /dev; sh MAKEDEV snd1
+.Ed
+.Pp
+Since the
+.Pa /dev/MAKEDEV
+utility creates symbolic links that will be used by
+many utilities by default,
+the device nodes and symbolic links for the
+preferred audio device in systems with multiple audio devices
+should be created last.
 .Sh DIAGNOSTICS AND TROUBLESHOOTING
 .Bl -tag -width 2m
 .It ac97: dac not ready