From owner-freebsd-current Tue Jun 27 2:32:25 2000 Delivered-To: freebsd-current@freebsd.org Received: from mppsystems.com (mppsystems.com [208.210.148.205]) by hub.freebsd.org (Postfix) with ESMTP id 9F13D37BED4 for ; Tue, 27 Jun 2000 02:32:21 -0700 (PDT) (envelope-from mpp@mppsystems.com) Received: (from mpp@localhost) by mppsystems.com (8.9.3/8.9.3) id EAA23309; Tue, 27 Jun 2000 04:29:00 -0500 (CDT) (envelope-from mpp) Date: Tue, 27 Jun 2000 04:29:00 -0500 From: Mike Pritchard To: Guido van Rooij Cc: Peter Wemm , current@FreeBSD.ORG Subject: Re: HEADS UP!: config changes... Message-ID: <20000627042900.A22797@mppsystems.com> References: <20000613231829.2F4BF1CD7@overcee.netplex.com.au> <20000624183247.A9232@mppsystems.com> <20000626212537.A51266@gvr.gvr.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: <20000626212537.A51266@gvr.gvr.org>; from guido@gvr.org on Mon, Jun 26, 2000 at 09:25:37PM +0200 Sender: owner-freebsd-current@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG On Mon, Jun 26, 2000 at 09:25:37PM +0200, Guido van Rooij wrote: > > How about adding a hint to the hint driver itself. E.g. > > SYNOPSIS > device isa > device ata > hint "hintsfile" # see hint(4) I don't think this is enough. If I botch my hints file enough (and lets say I fat finger some other files in /usr/src/sys/i386/conf. Been there, done that, so lets just assume that it will happen to other people), I should be able to figure out what I need to configure a device from the on-line man-pages. How about something like this: SYNOPSIS device isa device ata hints "hintsfile" # see hints(4) For ata devices on the isa bus, the hint file must contain: the bus that the device resides on (isa), the I/O port and IRQ. For the primary controller, port IO_WD1 and IRQ 14 are used. For the secondary controller, port IO_WD2 and IRQ 15 are used. Maybe the descriptive text could be replaced with something like: See the main text for a description of bus/port/IRQ/flag assignments. And then the main text would include something similar to what I typed above. Then hints(4) could tell the user the syntax they actually have to use and how to use it. If the syntax changes, then we only have to update the generic hints(4). From looking at "NOTES", mostly ISA devices are affected. ppc/scsi/miibus seem to be the other devices (plus another oddball or two). I think as long as we can decide how to provide the needed information in the device specific man pages, this shouldn't be too hard to actually sit down and do. Then someone also has to sit down and write hints(4) to back it all up :-). -Mike -- Mike Pritchard mpp@FreeBSD.org or mpp@mppsystems.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-current" in the body of the message