From owner-cvs-src@FreeBSD.ORG Fri May 12 17:04:39 2006 Return-Path: X-Original-To: cvs-src@freebsd.org Delivered-To: cvs-src@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8A98816A7BD; Fri, 12 May 2006 17:04:39 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from igloo.linux.gr (igloo.linux.gr [62.1.205.36]) by mx1.FreeBSD.org (Postfix) with ESMTP id AC3B843D62; Fri, 12 May 2006 17:04:33 +0000 (GMT) (envelope-from keramida@freebsd.org) Received: from gothmog.pc (aris.bedc.ondsl.gr [62.103.39.226]) (authenticated bits=128) by igloo.linux.gr (8.13.6/8.13.6/Debian-1) with ESMTP id k4CH4EP1004817 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Fri, 12 May 2006 20:04:15 +0300 Received: from gothmog.pc (gothmog [127.0.0.1]) by gothmog.pc (8.13.6/8.13.6) with ESMTP id k4CH6PdE026801; Fri, 12 May 2006 20:06:25 +0300 (EEST) (envelope-from keramida@freebsd.org) Received: (from giorgos@localhost) by gothmog.pc (8.13.6/8.13.6/Submit) id k4CH6PfX026800; Fri, 12 May 2006 20:06:25 +0300 (EEST) (envelope-from keramida@freebsd.org) Date: Fri, 12 May 2006 20:06:25 +0300 From: Giorgos Keramidas To: "Bruce A. Mah" Message-ID: <20060512170625.GF26040@gothmog.pc> References: <200605121255.k4CCtvhM066623@repoman.freebsd.org> <4464B5B6.8020704@freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <4464B5B6.8020704@freebsd.org> X-Hellug-MailScanner: Found to be clean X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (score=-3.972, required 5, autolearn=not spam, ALL_TRUSTED -1.80, AWL 0.43, BAYES_00 -2.60) X-Hellug-MailScanner-From: keramida@freebsd.org X-Spam-Status: No Cc: cvs-src@freebsd.org, src-committers@freebsd.org, cvs-all@freebsd.org Subject: Re: cvs commit: src/share/man/man4 ath.4 X-BeenThere: cvs-src@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the src tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 12 May 2006 17:04:43 -0000 On 2006-05-12 09:20, "Bruce A. Mah" wrote: >If memory serves me right, Giorgos Keramidas wrote: >> keramida 2006-05-12 12:55:56 UTC >> >> FreeBSD src repository (doc committer) >> >> Modified files: >> share/man/man4 ath.4 >> Log: >> After a mini-discussion with Sam Leffler, remove the hardcoded >> list of Atheros-based cards from ath(4). The online list is >> always more up to date, anyway. >> >> This invalidates: >> >> PR: docs/95360 http://www.FreeBSD.org/cgi/query-pr.cgi?pr=95360 >> Submitted by: Erik Nordstr:om Andersen > > Without expressing any opinion about the removal of this > information: This commit makes the hardware notes look rather > odd. (Remember that the hardware notes are partially generated > from manpages.) Here's the entry for ath(4), as well as the > the entry that immediately precedes it: > > Cards supported by the cnw(4) driver include: > > * Xircom CreditCard Netwave > > * NetWave AirSurfer > > A list of cards that are supported can be found at > http://customerproducts.atheros.com/customerproducts. The ath(4) > driver supports all Atheros Cardbus or PCI cards, except those > that are based on the AR5005VL chipset. > > It's not clear to me whether it'd be better to reword the above > sentences in the manpage to make them more suitable for "dual > use", or if it'd be better to hard-code some appropriate text > into the hardware notes. (In any case, please keep the Web > pointer in the hardware notes if possible.) Hmmm, I forgot about the special meaning of the "HARDWARE" section. What is a good way to write something that _can_ have a dual use?