From nobody@FreeBSD.org  Mon May 28 19:56:31 2012
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 21AFC106566C
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 28 May 2012 19:56:31 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id 0C2E48FC0A
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 28 May 2012 19:56:31 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id q4SJuUQb038515
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 28 May 2012 19:56:30 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id q4SJuUGV038501;
	Mon, 28 May 2012 19:56:30 GMT
	(envelope-from nobody)
Message-Id: <201205281956.q4SJuUGV038501@red.freebsd.org>
Date: Mon, 28 May 2012 19:56:30 GMT
From: Alessandro Chia <al.chia@yahoo.de>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Wrong/obsolete info in FreeBSD Handbook, Ch. 28.6.2 ("Using mpd")
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         168421
>Category:       docs
>Synopsis:       Wrong/obsolete info in FreeBSD Handbook, Ch. 28.6.2 ("Using mpd")
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    issyl0
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon May 28 20:00:11 UTC 2012
>Closed-Date:    Fri Jun 08 15:15:50 UTC 2012
>Last-Modified:  Fri Jun  8 15:20:09 UTC 2012
>Originator:     Alessandro Chia
>Release:        FreeBSD HAL 9.0-RELEASE
>Organization:
>Environment:
FreeBSD HAL 9.0-RELEASE FreeBSD 9.0-RELEASE #0: Tue Jan  3 07:15:25 UTC 2012     root@obrian.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC  i386

>Description:
At the beginning of chapter 28.6.2 ("Using mpd") of the FreeBSD handbook, there's a sample of the "mpd.conf" file. The "adsl" section lists the command "new -i ng0 adsl adsl". Yet, recent versions of mpd don't support the comman "new" anymore. So the description is obsolete and could lead to an mpd configuration that simply fails - just as it happened in my case.

Mpd version 5.6, which is included in ftp://ftp.freebsd.org/pub/FreeBSD/releases/i386/i386/9.0-RELEASE/packages/net/ has changed its command set, excluding the command "new" (why, remains a mystery to me). It is not mentioned in the changes section of the man page.

So, I don't know when the change happened, but I guess (inferring from the man pages) that "new" has become old with the jump from 4.x to 5.x.

A diff on the man pages of versions 4.x and 5.x shows that change:

mpd 4.x: http://mpd.sourceforge.net/doc/mpd23.html#23
mpd 5.x: http://mpd.sourceforge.net/doc5/mpd22.html#22
>How-To-Repeat:

>Fix:
Please clarify that the sample config given in the handbook refers to mpd versions 4.x. I cannot give a proper config for the 5.x series, as I have only a limited knowledge of mpd and thus have reverted to the perfectly working 4.x versions. So, unfortunately I cannot "fix the problem". 

(Anyway, thanks for the handbook - it's awesome :-)




>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->issyl0 
Responsible-Changed-By: issyl0 
Responsible-Changed-When: Thu Jun 7 10:07:15 UTC 2012 
Responsible-Changed-Why:  
I'll take it. 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/168421: commit references a PR
Date: Fri,  8 Jun 2012 15:06:04 +0000 (UTC)

 Author: issyl0
 Date: Fri Jun  8 15:05:45 2012
 New Revision: 39010
 URL: http://svn.freebsd.org/changeset/doc/39010
 
 Log:
   Add a note to a handbook chapter about the mpd.conf example only
   working for mpd version 4.
   
   PR:		docs/168421
   Submitted by:	Alessandro Chia (al.chia at yahoo dot de)
   Approved by:	gabor (mentor)
 
 Modified:
   head/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml
 
 Modified: head/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml
 ==============================================================================
 --- head/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml	Fri Jun  8 08:35:32 2012	(r39009)
 +++ head/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml	Fri Jun  8 15:05:45 2012	(r39010)
 @@ -2344,6 +2344,11 @@ ppp_profile="adsl"</programlisting>
          is spread over two files, first the
          <filename>mpd.conf</filename>:</para>
  
 +      <note>
 +	<para>This example of the <filename>mpd.conf</filename> file
 +	  only works with <application>mpd</application> 4.x.</para>
 +      </note>
 +
        <programlisting>default:
      load adsl
  
 _______________________________________________
 svn-doc-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-doc-all
 To unsubscribe, send any mail to "svn-doc-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->closed 
State-Changed-By: issyl0 
State-Changed-When: Fri Jun 8 15:13:09 UTC 2012 
State-Changed-Why:  
Committed.  Thank you! 

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

From: Isabell Long <issyl0@FreeBSD.org>
To: al.chia@yahoo.de, bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/168421: Wrong/obsolete info in FreeBSD Handbook, Ch. 28.6.2
 (&quot;Using mpd&quot;)
Date: Fri, 8 Jun 2012 16:12:04 +0100

 Hi Alessandro,
 
 The issue you reported about the mpd config file in the handbook is
 now fixed with a note on the page, as you suggested.
 
 Thanks for the report, and for using FreeBSD.
 
 Isabell.
>Unformatted:
