From owner-freebsd-doc@FreeBSD.ORG Mon Jan 5 11:11:48 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3E2F816A4CE; Mon, 5 Jan 2004 11:11:48 -0800 (PST) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id A9C0943D54; Mon, 5 Jan 2004 11:11:11 -0800 (PST) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (localhost [127.0.0.1]) by abigail.blackend.org (8.12.9/8.12.3) with ESMTP id i05JB9Bb084279; Mon, 5 Jan 2004 20:11:09 +0100 (CET) (envelope-from marc@abigail.blackend.org) Received: (from marc@localhost) by abigail.blackend.org (8.12.9/8.12.3/Submit) id i05JB3IL084278; Mon, 5 Jan 2004 20:11:03 +0100 (CET) (envelope-from marc) Date: Mon, 5 Jan 2004 20:11:03 +0100 From: Marc Fonvieille To: Tom Rhodes Message-ID: <20040105201103.B82370@abigail.blackend.org> References: <20040105053153.GA4776@devenoges.com> <20040105165632.GA75907@intruder.kitchenlab.org> <20040105134534.50571cee@localhost> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <20040105134534.50571cee@localhost>; from trhodes@FreeBSD.org on Mon, Jan 05, 2004 at 01:45:34PM -0500 X-Useless-Header: blackend.org X-Operating-System: FreeBSD 4.8-STABLE cc: "Bruce A. Mah" cc: doc@FreeBSD.org cc: Christoph Devenoges Subject: Re: supported hardware X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 05 Jan 2004 19:11:48 -0000 On Mon, Jan 05, 2004 at 01:45:34PM -0500, Tom Rhodes wrote: > > I've read over the comments made by Brooks Davis and must agree > that listing every device will be tedious if not annoying. But > if you look over the uscanner manual page it has a ton of devices > listed also. For the time you put into the release and hardware > notes, Bruce, you are to be soluted; I just cannot think of a > better alternative right now. We have the hardware notes, we > condence them by adding to the manual pages, now we have the > possibility of having bloated manual pages. It's a never-ending > battle. > > Off the top of my head, while it isn't the best idea in the world, > a single manual page with all the USB devices might be an option. > Something like usbdevs.4, and perhaps the ability to link to a > specific section via the hardware notes. Or just the manual page > with a simple comment: > > "Due to the overwhelming amount of USB devices FreeBSD supports, > a single manual page was added to list them all. Please scan through > this list for your specific device." > [...] This is a good idea and easy to set up. Marc