docs/152248: [patch] Handbook usage of cdda2wav is obsolete

[Warren Block]

>Number:         152248
>Category:       docs
>Synopsis:       [patch] Handbook usage of cdda2wav is obsolete
>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 Nov 14 19:20:08 UTC 2010
>Closed-Date:
>Last-Modified:
>Originator:     Warren Block
>Release:        8.1-STABLE
>Organization:
>Environment:
FreeBSD lightning 8.1-STABLE FreeBSD 8.1-STABLE #0: Sat Nov 13 07:44:34 MST 2010     root at lightning:/usr/obj/usr/src/sys/LIGHTNING  i386
>Description:
cdda2wav usage shown in the Handbook Storage/Creating and Using Optical Media (CDs) section produces a warning about numeric parameters to the -v option:

cdda2wav: Warning: numerical parameters for -v are no more supported in the next releases!
>How-To-Repeat:
% cdda2wav -v255 -D2,0 -B -Owav

>Fix:
Apply patch:

--- /usr/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml.orig	2010-11-14 12:11:41.000000000 -0700
+++ /usr/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml	2010-11-14 12:12:42.000000000 -0700
@@ -1159,7 +1159,7 @@
 	<step>
 	  <para>Use <command>cdda2wav</command> to extract the audio.</para>
 
-	  <screen>&prompt.user; <userinput>cdda2wav -v255 -D2,0 -B -Owav</userinput></screen>
+	  <screen>&prompt.user; <userinput>cdda2wav -vall -D2,0 -B -Owav</userinput></screen>
 	</step>
 
 	<step>


Patch attached with submission follows:

--- /usr/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml.orig	2010-11-14 12:11:41.000000000 -0700
+++ /usr/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml	2010-11-14 12:12:42.000000000 -0700
@@ -1159,7 +1159,7 @@
 	<step>
 	  <para>Use <command>cdda2wav</command> to extract the audio.</para>
 
-	  <screen>&prompt.user; <userinput>cdda2wav -v255 -D2,0 -B -Owav</userinput></screen>
+	  <screen>&prompt.user; <userinput>cdda2wav -vall -D2,0 -B -Owav</userinput></screen>
 	</step>
 
 	<step>


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