docs/155095: [PATCH] Multimedia chapter should mention dsp no longer created

[Chris Rees]

>Number:         155095
>Category:       docs
>Synopsis:       [PATCH] Multimedia chapter should mention dsp no longer created
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Feb 27 18:10:10 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator:     Chris Rees
>Release:        FreeBSD 8.1-RELEASE-p2 i386
>Organization:
>Environment:
System: FreeBSD zeus.bayofrum.net 8.1-RELEASE-p2 FreeBSD 8.1-RELEASE-p2 #0: Wed Feb 23 16:10:57 UTC 2011 root at zeus.bayofrum.net:/usr/obj/usr/src/sys/ZEUS i386


>Description:
	The /dev/dsp* files are no longer created when sound drivers are loaded, causing me to chase problems for ages on correct drivers... This could help others in the same boat
>How-To-Repeat:
	zeus# kldload sound && kldload snd_driver
	zeus# ls /dev/dsp*
	zeus# echo wtf has happened to my dsp files\?\?\?\?
>Fix:

	- Document the nature of /dev/dsp* -- not created until accessed

	Submitted by: Chris Rees (utisoft_at_gmail.com)

--- doc-handbook-sound.patch begins here ---
Index: books/handbook/multimedia/chapter.sgml
===================================================================
RCS file: /exports/cvsroot-freebsd/doc/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml,v
retrieving revision 1.139
diff -u -r1.139 chapter.sgml
--- books/handbook/multimedia/chapter.sgml	3 Dec 2010 09:38:53 -0000	1.139
+++ books/handbook/multimedia/chapter.sgml	27 Feb 2011 17:27:48 -0000
@@ -297,6 +297,11 @@
       This command line should produce some noise, confirming the
       sound card is actually working.</para>
 
+    <note>
+      <para>The files <filename>/dev/dsp*</filename> are only made when
+      touched/created; they will not appear under &man.ls.1; before then.</para>
+    </note>
+
     <para>Sound card mixer levels can be changed via the &man.mixer.8;
       command.  More details can be found in the &man.mixer.8; manual
       page.</para>
--- doc-handbook-sound.patch ends here ---




>Release-Note:
>Audit-Trail:
>Unformatted: