From nobody@FreeBSD.org  Sun Nov 14 19:18:13 2010
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 4B5EB106564A
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 14 Nov 2010 19:18:13 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 39DB08FC16
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 14 Nov 2010 19:18:13 +0000 (UTC)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id oAEJIDwe071522
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 14 Nov 2010 19:18:13 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id oAEJIDqj071521;
	Sun, 14 Nov 2010 19:18:13 GMT
	(envelope-from nobody)
Message-Id: <201011141918.oAEJIDqj071521@www.freebsd.org>
Date: Sun, 14 Nov 2010 19:18:13 GMT
From: Warren Block <wblock@wonkity.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [patch] Handbook usage of cdda2wav is obsolete
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         152248
>Category:       docs
>Synopsis:       [patch] Handbook usage of cdda2wav is obsolete
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    bcr
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Nov 14 19:20:08 UTC 2010
>Closed-Date:    Mon Nov 15 18:12:01 UTC 2010
>Last-Modified:  Mon Nov 15 18:12:01 UTC 2010
>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@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:
Responsible-Changed-From-To: freebsd-doc->bcr 
Responsible-Changed-By: bcr 
Responsible-Changed-When: Sun Nov 14 22:34:39 UTC 2010 
Responsible-Changed-Why:  
I'll investigate this. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=152248 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/152248: commit references a PR
Date: Mon, 15 Nov 2010 18:05:14 +0000 (UTC)

 bcr         2010-11-15 18:04:58 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/handbook/disks chapter.sgml 
   Log:
   The -v parameter of cdda2wav does not support numerical values in newer
   releases and produces a warning when invoked like that. Change the example
   to use the correct non-numeric form.
   
   PR:             docs/152248
   Submitted by:   Warren Block (wblock at wonkity dot com)
   
   Revision  Changes    Path
   1.298     +1 -1      doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->closed 
State-Changed-By: bcr 
State-Changed-When: Mon Nov 15 18:11:32 UTC 2010 
State-Changed-Why:  
Patch committed, thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=152248 
>Unformatted:
