From owner-freebsd-doc@FreeBSD.ORG Mon Jan 5 10:45:34 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 D5A1816A4CE; Mon, 5 Jan 2004 10:45:34 -0800 (PST) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id CF44943D49; Mon, 5 Jan 2004 10:45:32 -0800 (PST) (envelope-from trhodes@FreeBSD.org) Received: from localhost (acs-24-154-239-203.zoominternet.net [24.154.239.203]) by pittgoth.com (8.12.10/8.12.10) with SMTP id i05IjSCv010862; Mon, 5 Jan 2004 13:45:29 -0500 (EST) (envelope-from trhodes@FreeBSD.org) Date: Mon, 5 Jan 2004 13:45:34 -0500 From: Tom Rhodes To: "Bruce A. Mah" Message-Id: <20040105134534.50571cee@localhost> In-Reply-To: <20040105165632.GA75907@intruder.kitchenlab.org> References: <20040105053153.GA4776@devenoges.com> <20040105165632.GA75907@intruder.kitchenlab.org> X-Mailer: Sylpheed version 0.9.8claws (GTK+ 1.2.10; i386-portbld-freebsd5.2) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: trhodes@FreeBSD.org 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 18:45:35 -0000 On Mon, 5 Jan 2004 08:56:32 -0800 "Bruce A. Mah" wrote: > If memory serves me right, Christoph Devenoges wrote: > > > if i connect my nikon SQ digicam via USB, (after setting USB mode to Mass > > Storage in the camera setup menu) > > > > this appears: > > > > umass0: Nikon Nikon COOLPIX SQ, rev 1.10/1.00, addr 3 > > da0 at umass-sim0 bus 0 target 0 lun 0 > > da0: Removable Direct Access SCSI-2 device > > da0: 1.000MB/s transfers > > da0: 983MB (2013922 512 byte sectors: 64H 32S/T 983C) > > > > you might what to add this to the 5.1|2 i386 supported hardware list > > with the other umass driven hardware. > > I (with the help of several other folks) have been trying to move > instances of specific devices out of the hardware list (where it > largely duplicates the content in manual pages) into the manual pages. > > umass(4) has some of this content already, but before somebody brings > over the devices from the hardware list, there's a question of how > long we want that manual page to get. There's a *lot* of umass(4) > devices in the world and it's not clear to what extent we want to even > *try* to exhaustively list everything there. > > I see where trhodes@ has done some work on this manpage recently. > Tom, I haven't had a chance to ask you about this yet, but do you have > an opinion on how to handle this? 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." Otherwise i'll have to sleep on this. -- Tom Rhodes