Bug 168421
| Summary: | Wrong/obsolete info in FreeBSD Handbook, Ch. 28.6.2 ("Using mpd") | ||
|---|---|---|---|
| Product: | Documentation | Reporter: | Alessandro Chia <al.chia> |
| Component: | Books & Articles | Assignee: | Isabell Long <issyl0> |
| Status: | Closed FIXED | ||
| Severity: | Affects Only Me | ||
| Priority: | Normal | ||
| Version: | Latest | ||
| Hardware: | Any | ||
| OS: | Any | ||
Responsible Changed From-To: freebsd-doc->issyl0 I'll take it. 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" 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. State Changed From-To: open->closed Committed. Thank you! |
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 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 :-)