From owner-freebsd-doc@FreeBSD.ORG Thu Jan 19 15:09:47 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 15B0F1065675; Thu, 19 Jan 2012 15:09:47 +0000 (UTC) (envelope-from jhb@freebsd.org) Received: from cyrus.watson.org (cyrus.watson.org [65.122.17.42]) by mx1.freebsd.org (Postfix) with ESMTP id DBB5B8FC1C; Thu, 19 Jan 2012 15:09:46 +0000 (UTC) Received: from bigwig.baldwin.cx (bigwig.baldwin.cx [96.47.65.170]) by cyrus.watson.org (Postfix) with ESMTPSA id 86B2C46B0D; Thu, 19 Jan 2012 10:09:46 -0500 (EST) Received: from jhbbsd.localnet (unknown [209.249.190.124]) by bigwig.baldwin.cx (Postfix) with ESMTPSA id 018A4B946; Thu, 19 Jan 2012 10:09:46 -0500 (EST) From: John Baldwin To: freebsd-doc@freebsd.org Date: Thu, 19 Jan 2012 10:09:44 -0500 User-Agent: KMail/1.13.5 (FreeBSD/8.2-CBSD-20110714-p10; KDE/4.5.5; amd64; ; ) References: In-Reply-To: MIME-Version: 1.0 Message-Id: <201201191009.45027.jhb@freebsd.org> Content-Type: Text/Plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Greylist: Sender succeeded SMTP AUTH, not delayed by milter-greylist-4.2.7 (bigwig.baldwin.cx); Thu, 19 Jan 2012 10:09:46 -0500 (EST) Cc: Adam Kirchhoff , simon@freebsd.org Subject: Re: FreeBSD 9.0-RELEASE Hardware Notes is wrong. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 19 Jan 2012 15:09:47 -0000 On Wednesday, January 18, 2012 8:01:17 pm Benjamin Kaduk wrote: > On Wed, 18 Jan 2012, Adam Kirchhoff wrote: > > > http://www.freebsd.org/releases/9.0R/hardware.html > > > > This section is correct: > > > > [i386,amd64] The snd_emu10kx(4) driver supports the following sound cards: > >> Creative Sound Blaster Live! (EMU10K1 Chipset). Both PCM and MIDI > >> interfaces are available. > >> Creative Sound Blaster Audigy (CA0100 and CA0101 Chipset). PCM and two > >> MIDI interfaces available. > >> Creative Sound Blaster Audigy 2 and Creative Sound Blaster Audigy 4 > >> (CA0102 Chipset). PCM support is limited to 48kHz/16 bit stereo (192kHz/24 > >> bit part of this chipset is not supported). > >> Creative Sound Blaster Audigy 2 Value (CA0108 Chipset). PCM support is > >> limited to 48kHz/16 bit stereo (192kHz/24 bit part of this chipset is not > >> supported). There is no MIDI support for this card. > > > > > > > > This section is wrong: > > > > > > The snd_emu10kx(4) driver does support the following sound cards (although > >> they have names similar to some supported ones): > >> Creative Sound Blaster Live! 24-Bit, identified by FreeBSD as > >> Creative Sound Blaster Audigy LS / ES, identified by FreeBSD as > >> All other Creative sound cards with -DAT chipsets. > >> All Creative X-Fi series sound cards. > > > > > > > > None of those cards are supported by snd_emu10kx (according to the man > > page, and in my own personal experience). I believe a "does support" should > > read "does not support". > > Looks like the second one should be "does not support", yes. > > Thanks for spotting it; hopefully I can prod a committer into making the > change. The snd_emu10kx(4) manpage from which this is derived is correct. This appears to be a problem with the code that parses the manpages to generate the hardware release notes. Maybe it is confused by the markup: The .Nm driver does .Em not support the following sound cards (although they have names similar to some supported ones): This change fixes it. If simon ok's it I'll commit it. It does result in a new header line for malo(4) making it into the hardware notes (it may be that the malo(4) manpage needs to format it's hardware table differently anyway). Index: release/doc/share/misc/man2hwnotes.pl =================================================================== --- man2hwnotes.pl (revision 230267) +++ man2hwnotes.pl (working copy) @@ -324,6 +324,11 @@ sub parse { } elsif (/^Fx/) { dlog(3, "Got Fx command"); parabuf_addline(\%mdocvars, "FreeBSD"); + } elsif (/^Em (.+)$/) { + my ($txt, $punct_str) = split_punct_chars($1); + + parabuf_addline(\%mdocvars, + normalize("$txt$punct_str")); } else { # Ignore all other commands. dlog(3, "Ignoring unknown command $cmd"); -- John Baldwin